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SUMMARY  OF  TECHNICAL  CHANGES 


This  update  of  the  RSX-llS  System  Generation  and  Installation  Guide 
reflects  changes  to  tFe  VAX/VMS  Version  3.0  operating  system  that 
affect  Chapter  7,  System  Generation  on  a  VAX/VMS  Host.  Following  are 
the  changes  that  have  been  made: 

•  If  you  are  generating  an  RSX-llS  operating  system  on  a  VAX/VMS 
V3.0  host,  you  no  lorger  have  to  increase  the  CLISYMTBL  size; 
CLISYMTBL  is  now  set  at  40  pages. 

•  VAX/VMS  V3.0  provides  the  qualifier  /STRUCTURE=1  for  use  with 
the  INI  command  to  initialize  the  volume  as  a  FilfiS-11 
Structure  Level  1  volume  during  SYSGEN.  With  a  Files-11 
Structure  Level  1  volume,  you  can  transfer  files  between 
VAX/VMS  and  RSX  operating  systems. 

•  If  you  answer  yes  to  question  15  during  SYSGEN,  IISGEN 
generates  a  series  of  PIP  commands  that  appear  on  your 
terminal.   These  commands  delete  files  from  previous  llSGENs. 

•  The  VAX/VMS  MCR  SET  NOON  command  appears  on  your  terminal. 
SET  NOON  disables  error  checki'^g  following  the  execution  of  a 
command.   IISGEN  generates  the  SET  NOON  command. 

•  BASMCR's  size  has  increased  from  6400  to  13700  octal  to  6400 
to  14000  octal. 

•  MCRPAR's  default  length  has  increased  from  13700  to  14000 
octal. 

•  The  SET/UIC=[g,m]  command  echoes  back  as  SET  UIC  [g,m] . 
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CHAPTER  1 
INTRODUCTION  TO  RSX-llS 


RSX-llS  is  the  memory-resident  version  of  the  RSX-llM  operating 
system.  RSX-llS  and  the  tasks  that  run  on  it  are  created  on  a  host 
RSX-llM,  RSX-llM-PLUS,  or  VAX/VMS  operating  system  and  then 
transported  to  the  target  system. 

The  following  sections  describe  the  memory-resident  concept  of 
RSX-llS,  the  host/target  relationship,  the  hardware  and  software 
configuration  for  an  RSX-llS  system,  and  the  Virtual  Monitor  Control 
Routine. 


1.1   MEMORY-RESIDENT  SYSTEM 

RSX-llS  is  fully  compatible  internally  with  RSX-llM,  supports  an 
identical  I/O  driver  interface,  and  is  a  compatible  subset  at  the  user 
level . 

Because  RSX-llS  is  memory-resident,  it  does  not  support  a  file  system, 
nonresident  tasks,  checkpointing,  disk-resident  overlaid  tasks 
(memory-resident  overlaid  tasks  are  supported) ,  or  program 
d'=^velopment .  Its  main  purpose  is  to  provide  a  run-time  environment 
for  executing  tasks. 

The  user  interface  to  the  RSX-llS  system  is  supplied  by  a  subset  of 
the  RSX-llM  Monitor  Console  Routine  (MCR)  called  Basic  MCR.  Strict 
subset  compatibility  is  provided. 

Four  additional  groups  of  privileged  tasks  are  available  for  inclu*-  oi 
in  an  RSX-llS  system: 

•  The  On-Line  Task  Loader  (OTL)  is  used  to  install,  lo£d,  and 
fix  tasks  in  a  r...ming  RSX-llS  system. 

•  The  System  Image  Preservation  program  (SIP)  saves  an  image  of 
an  operational  RSX-llS  system  for  subsequent  bootstrapping. 

•  The  Task  Termination  Notification  program  (TKTN)  outputs 
messages  about  device  status  and  abnormal  task  termination. 

•  The  set  of  display  tasks  (RSDV05,  RSDV52,  and  RSOVIH)  provides 
video  terminal  displays  of  information  concerning  activity  in 
the  RSX-llS  system. 
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1 . 2   HOST/TARGET  SYSTEMS 

Program  development  and  system  generation  for  an  RSX-llS  system 
require  a  host  RSX-llM  (Version  4.0),  RSX-llM-PLUS  (Version  1.0  or 
2.0),  or  VAX/VMS  (Version  2.4  or  later)  operating  system.  You  can 
write  tasks  in  MACRO-11  or  other  supported  liigher-level  languages, 
assemble/compile  and  link  them  on  the  host  system,  and  then  transport 
them  to  an  RSX-llS  target  system  for  execution. 

An  RSX-llS  system  is  generated  on  a  host  system  in  two  phases.  The 
user  interacts  with  the  system  generation  program  to: 

(Phase  1)  -  Define  the  RSX-llS  system  hardware  configuration, 
and  assemble  the  Executive,  device  drivers,  and 
laboratory  device  drivers. 

(Phase  2)  -  Task-build  the  Executive,  device  drivers,  and  all 
privileged  tasks;  configure  the  RSX-llS  target 
system. 

The  complete  RSX-llS  system  is  constructed  on  the  host  system  under 
the  control  of  command  files  and  an  RSX-llM  utility  task  called  the 
Virtual  Monitor  Console  Routine  (VMR;   see  Section  1.4). 

The  three  methods  of  transporting  tasks  from  a  host  to  a  running 
RSX-llS  system  are: 

1.  Use  the  VMR  FIX  command  on  the  host  system  to  fix  all  of  your 
tasks  in  the  RSX-llS  system  image  before  writing  the  image  to 
the  transporting  medium. 

Using  VMR,  you  can  specify  partitions,  load  device  drivers, 
and  install/fix  tasks;  you  can  perform  these  operations 
before  transporting  the  RSX-llS  image. 

2.  Use  the  File  Transfer  Util 'ty  Prog. am  (FLX;  see  the 
RSX-llM/M-PLUS  Utilities  Manual)  on  the  host  to  write  a  task 
to  the  transport  medium;  then  use  the  On-Line  Task  Loader 
(OTL)  to  read  the  task  from  the  medium  and  load  it  into 
memory. 

3.  If  vou  have  DECnet  support  in  both  the  host  and  the  target 
RSX-llS  systems  (DECNET-VAX  V2.0  for  VAX/VMS),  down-line 
task-load  from  a  host. 


1 . 3   HARDWARE/SOFTWARE  CONFIGURATIONS 

RSX-llS  is  a  hardware/software  system  capable  of  growing  from  an  8K 
word  configuration  to  a  1920K  word  system  with  a  large  number  of 
peripherals.  It  supports  all  PDP-11  processors  from  the  LSI-11 
through  the  PDP-11/70.  Because  it  is  based  on  and  is  internally 
compatible  with  RSX-llM,  it  enjoys  most  of  the  inherent  features  of 
that  system.  For  example,  RSX-llS  automatically  supports  all  of  the 
peripheral  devices  (e-tcept  the  console  logger  device)  that  RSX-llM 
supports.  This  capability  also  extends  to  other  hardware  features 
such  as  floating  point,  parity  memory,  and  memory  management.  You 
select  the  options  you  want  during  system  generation.  Note  that  the 
mote  options  you  select,  the  more  memory  yoiit  system  will  requir-. 
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The  basic  software  building  blocks  for  an  RSX-llS  system,  and  their 
approximate  sizes  (in  decimal),  are: 

1.  A  subset  of  the  features  available  in  the  RSX-llM  Executive 
(2.5  to  4.5K  words) 

2.  All  RSX-llM  V4.0  I/O  device  drivers,  except  the  console 
logger  device  driver  (most  drivers  use  an  average  of  1.5K 
words;  che  line  printer  driver  needs  less,  the  terminal 
driver  needs  more) 

3.  Basic  MCR  (3K  words) 

4.  On-Line  Task  Loader  (3.5K  words) 

5.  System  Image  Preservation  program  (2K  words) 

6.  Task  Termination  Notification  program  (IK  words) 

7.  System  activity  display  programs  RSDV05,  RSDV52,  and  RSDVIH 
(6K  words) 

The  minimum  software  system  is  a  2.5K  Executive.  However,  you  must 
augment  this  minimal  Executive  with  other  software  for  it  to  do  useful 
work.  For  example,  two  to  four  I/O  drivers  could  be  added  at  the 
average  cost  of  an  additional  1.5K  words  of  memory  for  each  of  them. 

If  operator  communication  is  required,  you  can  include  Basic  MCR  in  a 
system,  with  a  resulting  3K-word  increase  in  memory  requirements. 

On-line  task  loading  in  a  system  tnat  is  designed  with  4K  words  for 
user  tasks  requires  a  minimum  14.5K-word  system  because  approximately 
10. 5K  words  is  required  for  system  software  (that  is,  2.5K-word 
Executive,  3K-word  MCR,  1.5K-word  I/O  drivers,  and  3.5K-word  OTL) . 


1.4   VIRTUAL  MCR 

Virtual  MCR  (VMR)  is  an  RSX-llM  system  program  that  allows  the 
complete  interactive  configuration  of  an  RSX-llS  system.  You  can 
define  partitions,  load  and  unload  device  drivers,  install  and  fix 
tasks,  and  establish  other  system  parameters.  You  can  then  transfer 
the  entire  system  to  an  appropriate  load  medium  for  bootstrapping  on 
the  target  system. 

VMR  is  fully  documented  in  the  RSX-llM/M-PLUS  System  Management  Guide. 

The  VMR  task  use  3  on  an  RSX-llM-PLUS  host  for  generating  an  RSX-llS 
system  is  the  RSX-llM  VMR.  It  is  installed  and  run  under  the  name 
VMM,  but  it  still  prompts  with  VMR>.  (The  RSX-llM-PLUS  host  must  also 
use  the  RSX-llM  Task  Builder.) 

VAX/VMS  also  uses  the  RSX-llM  VMR  for  generating  an  RSX-llS  system. 
It  is  installed  and  run  under  the  name  VMR.  (The  VAX/VMS  host  must 
also  use  the  RSX-llM  Task  Builder.) 
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CHAPTER  2 
RSX-llS  SUPPLIED  SOFTWARE 

The  software  supplied  for  RSX-llS  includes: 

•  Basic  MCR,  which  is  the  user  interface 

•  On-Line  Task  Load'ir  (OTL)  ,  which  installs,   loads,   and   fixes 
tasks 

•  System  Image  Preservation  program  (SIP),   which  saves  system 
images  for  subsequent  bootstrapping 

•  Task  Termination  Notification  program   (TKTN) ,   which  outputs 
messages  about  abnormal  task  termination  and  device  status 

•  SETTIM  subroutine,  which  sets  the  system  time 

•  System  display  tasks   (RSDV05,   RSDV52,   and   RSDVIH) ,   which 
display  on  video  terminals  information  about  system  activity 

•  RSX-llS  File  Control  Services  (FCS) ,  which  are  a  subset  of  the 
RSX-llM  FCS  and  perform  basic  record  I/O 

The  following  sections  describe  these  tasks.  Chapter  4  contains 
information  on  how  to  build  the  tasks  during  the  RSX-llS  system 
generation  procedure. 


2.1   BASIC  MCR 

Basic  MCR,  the  user  interface  to  RSX-llS,  is  a  subset  of  the  RSX-llM 
Monitor  Console  Routine  (MCR) .  Basic  MCR  provides  commands  to  control 
and  modify  the  execution  of  tasks  installed  in  an  RSX-llS  system.  If 
Basic  MCR  is  to  be  included  in  the  RSX-llS  system,  you  must  configure 
a  terminal  driver  and  at  least  one  terminal  interface  (DLll,  DHll, 
DJll,  or  DZll)  into  the  target  system.  See  Section  4.5.1.2  for 
information  on  building  the  Basic  MCR  task. 


2.1.1  Initiating  Basic  MCR 

To  use  Basic  MCR  in  an  RSX-llS  system,  you  must  have   installed   and 
fixed  Basic  MCR  in  the  system  image  by  running  VMR  on  the  host  system. 
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2.1.2  Basic  MCR  Cownands 

MCR  commands  are  fully  documented  in  the  RSX-llM/M-PLUS  MCR  Operations 
Manual.   A  synopsis  of  the  Basic  MCR  commands  is  given  below. 

Initialization  Command 

TIM[E]     [hrs:mins[:secs] ] [month/day/year] 
Set   the   system  clock. 

Task  Control  Commands 

ABO[RT]  taskname 

Abort  the  spocified  task. 

CAN[CEL]  taskname 

Cancel  all  time-based  schedule  requests  for  the  specified 
task. 

RED[IRECT]  new:=old: 

Redirect  all  I/O  for  the  old  device  to  the  new  device. 

REM[OVE]  taskname 

Remove  the  specified  task  from  the  system  and  release  its 
partition. 

RES[UME]  taskname 

Resume  the  execution  of  the  specified  task  that  issued  a 
SUSPEND  directive. 

RUN  taskname  [/keyworo-1] [/keyword-2] 

Cause  the  specified  task  to  be  executed. 

RUN  taskname  dtime  [/keyword-1] [/keyword-2] 

Cause  the  specified  task  to  be  executed  at  the  specified 
number  of  time  units  from  command  issuance. 

RUN  taskname  sync  [dtime] [/keyword-1] [/keyword-2] 

Cause  the  specified  task  to  be  executed  at  the  specified 
number  of  time  units  following  the  next  specified  whole  time 
unit. 

RUN  taskname  atime  [/keyword-1] [/keyword-2] 

Cause  the  specified  task  to  be  executed  at  a  specified  time 
of  day. 

Keywords: 

/RSI  -  nnnnu 

/UIC  -  [group-number , member-number] 


2-2 


RSX-llS  SUPPLIED  SOFTWARE 

For  /RSI  (rescheduling  interval),  nnnn  is  the  number  of 
units  to  be  clocked  and  u  is  the  units  field.  The  units 
field  can  be  T  (ticks) ,  S  (seconds)  ,  M  (minutes) ,  or  H 
(hours.)  The  number  of  units  cannot  exceed  24  hours  in  the 
specified  unit. 

System  Maintenance  Commands 

ATL^ 

Display  status  of  all  active  tasks. 
BRk2 

Breakpoint  to  Executive  debugging  tool  (XDT) . 

OPE[N]  memory-address  [+  or  -n]  [/keyword] ■'■ 

The  contents  of  the  effective  address  are  displayed  as  shown 
below.  On  mapped  systems,  the  effective  address  is  formed 
by  decoding  the  specified  memory  address;  applying  the 
optional  additive  term  (+  or  -) ;  and,  if  the  optional 
keyword  PAR  is  specified,  using  the  result  as  an  offset  from 
the  start  of  the  partition.  On  unmapped  systems,  only  the 
memory  address  argument  is  permitted.  After  the  slash,  you 
can  enter  an  optional  value  to  replace  contents-of-address, 
followed  by  one  of  the  line  terminator  options. 

(memory-address)  (contents-of-address) /[value] line-terminator 

Keyword: 

Applicable    to 
/PAR     =  parMtion-narae       mapped   systems 

only 

Line  Terminator  Options: 

lie)  =  Escape  or  ALTMODE:  No  additional  location 
is  opened  and  the  OPEN  command  is 
terminated.  The  ESC  (or  ALTMODE)  key  is  the 
only  means  of  exit  from  the  MCR  OPEN 
function. 

®  =  Carriage  return:  The  next  sequential 
location  is  opened. 

"®  =  Circumflsjx  (up-arrow  on  some  terminals) 
carriage  return:  The  previo's  location  is 
opened. 


1.  Optionally  selectable  during  RSX-llS  system  generation. 

2.  Included  if  Executive  debugging  tool   was  selected  during   system 
generation. 
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*(i@      =  Asterisk  carriage  return  or  at-sign  carriage 
or        return:   The   location  pointed   to   by  the 
§®        final  contents  of  the  current  location   is 
opened. 


Display  status  of  all  tasks  installed  in  the  system. 


2.1.3  Basic  MCR  Error  Messages 

You  can  assemble  Basic  MCR  with  long  or  short  error  messages.  Long 
error  messages  identify  which  component  of  Basic  MCR  is  the  source  of 
the  message  and  give  both  a  numeric  error  code  and  an  ASCII 
description  of  the  error  condition.  Short  error  messages  exclude  the 
ASCII  description,  thus  conserving  memory  space.  As  distributei, 
Basic  MCR  assembles  with  short  error  messages.  You  can  assemble  Basic 
MCR  with  long  error  messages  by  editing  the  file  BMPRE.MAC  in  11SGEN2 
(see  Section  4.5.1.2). 

Basic  MCR  generates  the  following  error  messages,  which  are  shewn  in 
their  long  form.  (In  the  short  form,  only  the  task  name  and  error 
code  number  are  given.)  The  meaning  of  each  message  is  also  given. 
The  XXX  in  the  messages  indicates  the  3-character  component  name  of 
MCR  that  detected  the  error. 

XXX  —   1  -  ILLEGAL  FUNCTION 

A  command  was  entered  that  MCR  could  not  recognize. 

XXX  ~   2  -  SYNTAX  ERROR 

This  message  generally  indicates  that  the  required  information 
was  entered  incorrectly.  You  can  usually  correct  this  condition 
by  retyping  the  arguments  according  to  the  command  specification. 

XXX  ~   3  -  NO  POOL  SPACE 

The  Executiva  could  not  satisfy  MCR's  request  for  dynamic  memory. 

XXX  —   4  -  INVALID  KEYWORD 

A  keyword  was  encountered  that  the  specified  command  processor 
could  not  recognize. 

XXX  —      u    -   DEVICE  NOT  iN  SYSTEM 

The  device  specified  in  the  command  was  not  generated  into  the 
system.  Devices  to  be  used  in  the  system  must  be  specified 
during  system  generation. 

XXX  —   6  -  PRIVILEGED  COMMAND 

A  command  that  is  available  only  to  privileged  terminals  was 
issued  from  a  nonprivileged  terminal. 


1.  Optionally  selectable  during  RSX-llS  system  generation, 
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XXX  —   7  -  PARTITION  NOT  IN  SYSTEM 

The  partition  name  specified  as  an  argument  in  a  command  could 
not  be  found  in  the  system. 

XXX  ~   8-10  ERROR 

In  attempting  to  read  the  next  command,  OPEN  detected  an  error, 
or  an  MCR  terminal-write  operation  failed. 

XXX  —   9  -  BYTE  ADDRESS 

The  address  specified  as  the  argument  to  the  OPEN  command  was  an 
odd  address. 

XXX  —  10  -  INVALID  TIME  PARAMETER 

A  time  field  was  incorrect. 
XXX  —  11  -  TASK  no;  JN  SYSTEM 

The  referenced  task  was  not  installed  in  the  system. 

XXX  —  12  -  INVALID  ADDRESS 

The  address  specified  as  an  argument  in  the  OPEN  command 
referenced  a  nonexistent  memory  location  or  an  address  outside 
the  boundaries  of  the   specified  partition. 

XXX  —  13  -  TASK  NOT  ACTIVE 

The  specified  task  was  not  active. 

XXX  —  14  -  TASK  BEING  ABORTED 

A  request  for  the  execution  of  a  task  was  made,  bi  ♦:  the  task  was 
being  aborted  because  of  an  error  or  an  MCR  ABORT  command. 

XXX  —  15  -  TASK  NOT  SUSPENDED 

The  task  used  as  the  argument  of  the  RESUME  co-nmand  was  not 
suspended  at  the  time  the  command  was  issueJ. 

XXX  —  16  -  TASK  ACTIVE 

The  task  used  as  the  argument  of  the  command  was  active. 

XXX  —  17  -  CIRCULAR  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  a  device  such  that  a  circular 
list  of  redirects  would  result. 

XXX  —  18  -  OLD  DEVICE  NOT  KNOWN  TO  SYSTEM 

An  attempt  was  made  to  redirect  an  unknown  device  unit. 

XXX  —  19  -  NEW  DEVICE  NOT  KNOWN  TO  SYSTEM 

The  new  device  in  the  REDIRECT  command  was  not  known  to  the 
system  (did  not  exist  in  the  device  tables)  . 

XXX  —  20  -  PSEUDO  DEVICE  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  a  pseudo  device  to  another  pseudo 
device. 
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XXX  --  21  -  OLD  DEVICE  ATTACHED 

An  attempt  was  made  to  redirect  an  attached  device  unit. 
XXX  —  22  -  TI  REDIRECT  ERROR 

The  pseudo  device  TI:   cannot  be  redirected. 

XXX  ~  23  -  INVAflD  UIC 

A  value  of  0  for  either  the  group  number  or  the  member  number  was 
detected . 

XXX  —  24  -  ILLEGAL  KEYWORD  VALUE 

A  value  entered  for  a  keyword  exceeded  its  limits.   Enter  a  valid 
value . 

XXX  —  26  -  LISTING  DEVICE  NOT  AVAILABLE 

The  device  unit  to  which  MCR  is  attempting  to  display  information 
was  attached  and  therefore  unavailable  for  printed  output. 

XXX  ~  27  -  DEVICE  NOT  REDIRECTABLE 

The  specified  device  cannot  be  redirected. 

2.2   ON-LINE  TASK  LOADER 

The  RSX-llS  On-Line  Task  Loader  (OTL)  performs  the  same  functions  as 
those  of  the  MCR  INSTALL  and  FIX  commands  in  RSX-llM.  The  task  images 
(including  common  blocks)  read  by  OTL  are  produced  by  tht  RSX-llM  Task 
Builder  and  transferred  to  a  load-device  medium  by  means  of  FLX.  OTL 
reads  a  task  image  from  the  load-device  medium,  verifies  the  task 
image  format,  and  checks  for  error  conditions.  It  then  creates  a  Task 
Control  Block  (TCB)  for  the  task,  places  the  TCB  in  the  System  Task 
Directory  (STD) ,  and  fixes  the  task  in  memory,  thus  making  the  task 
known  to  the  system.  For  system-controlled  partitions,  OTL  allocates 
a  subpartition  PCS  (Partition  Control  Block)  for  the  task. 

OTL  expects  the  load-device  medium  to  be  written  in  either  DOS  or 
RT-11  format,  depending  on  the  load  device.  The  load  devices 
supported  by  OTL,  and  their  required  formats,  are: 

PCll/PRll  paper  tape  (PR)  —  DOS  format 

RXll  flexible  disk  (UX)  --  RT-11  format 

RX211  flexible  disk  (DY)  --  RT-11  format 

TAll  cassette  tape  (CT)  —  DOS  format 

TCll  DECtape  (DT)  —  RT-11  format 

TU58  DECtape  II  (DD)  --  RT-11  format 

TM/TMA/TMBll  magnetic  tape  (MT)  —  DOS  format 

TM02/TU16-45  magnetic  tape  (MM)  --  UOS  for!«2t 

TSll  magnetic  tape  (MS)  —  nos  format 
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To  transfer  a  task  image  to  a  load-device  medium  other  than  paper 
tape,  you  must  first  initialize  the  volume  with  the  File  Transfer 
Utility  Program  (if  this  has  not  already  been  done).  The  /RT  switch 
must  be  specified  if  the  medium  is  to  be  written  in  RT-11  formac.  You 
can  then  transfer  the  task  image  file  to  the  load  device  with  a  PLX 
transfer  command,  specifying  the  appropriate  format  switch  (/RT  or 
/DO)  on  the  output  side  and  the  /RS  switch  (for  Files-11  format)  on 
the  input  side. 


For  example, 
[1,50]  on  SY 


to  transfer  the  task  image  file   SIP.TSK   from  directory 
to  a  cassette,  you  can  type  the  following  FLX  commands: 


FLX>CT: [1,50]/ZE/DO 
FLX>CT:/UI/DO=[1,50]SIP.TSK/RS 

To  transfer  the  same  file  to  an  RXOl  flexible  disk,  you  could  type: 

FLX>DX: [1,50]/ZE/RT 
FLX>DX:/UI/RT=[1,50]SIP.TSK/RS 

For  a  full   description   of   FLX,   see   the   RSX-llM/M-PLUS   Utilities 
Manual . 


NOTE 


Because  FLX  is  sensitive  to  the  file 
type  in  input  file  specifications,  it  is 
strongly  recommended  that  the  standard 
type  .TSK  always  be  used  to  ensure  that 
task  image  files  are  written  on 
load-device  media  in  the  proper  format. 


See  Section  4.5.1.3  for  information  on  building  the  OTL  task, 


2.2.1   Initiating  OTL 


To  use  OTL  in  an  RSX-llS  system,  both  OTL  and  Basic  MCR  must  have  been 
installed  and  fixed  in  the  system  image  by  Virtual  MCR  (VMR)  during 
the  system  generation  process  while  running  on  a  host  system  (see  the 
RSX-llM/M-PLUS  System  Management  Guide  and  Chapter  1  of  this  manual) . 
You  can  then  initiate  OTL  in  the  RSX-llS  system  by  entering  the 
following  Basic  MCR  command: 


>RUN  OTL 


OTL  then  begins  execution  and  indicates 
command  line  by  prompting  with: 


its   readiness   to   accept   a 


OTL> 

To  exit  from  OTL,  you  must  type  the  CTRL/Z  character  (typed  by  holding 
down  the  CTRL  key  and  pressing  the  Z  key).  The  OTL  command  line  has 
the  format: 


OTL>dev: [ufd] filename. type[/INC»n. ] 


dev ; 


The  load  device  unit  containing  the  task  image  file, 
default  for  dev:;   it  must  be  specified. 


There  is  no 
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[ufd] 


The  User  File  Directory  (UFD),  consisting  of  a  group  number  and  a 
member  number  in  the  form  [g,m].  This  UFD  is  associated  with  the 
task  image  file.  The  UFD  need  not  be  specified  and  is  ignored 
for  all  devices  except  magnetic  tape  (MM:,  MS:,  and  MT:).  The 
default  UFD  is  the  same  as  the  UIC  (User  Identification  Code) 
under  which  OTL  is  running. 


filename 


type 


The   6-character    alphanumeric    file   name  of    the  task      image      file. 

There    is  no  default    for    file   name.        t  must   be  specified   with   all 

devices     except      paper      tape      readers  (PR:),  for      which      it      is 
optional . 


The  3-character  alphanumeric  file-type  field  (preceded  by  a 
period).  The  file  type  need  not  be  specified;  its  default  is 
.TSK.  OTL  interprets  a  file  name  followed  only  by  a  period  as 
the   specification   for   a   null    file   type. 

/INC=n. 

The  switch  to  increment  the  size  of  the  task  by  the  specified 
numbfcr  of  octal  bytes  (or  decimal,  if  followed  by  a  period). 
This  allows  buffering  space  at  the  end  of  the  task. 

Blanks  and  tabs  are  not  allowed  in  an  OTL  command  line. 

Examples : 

OTL>DX:SIP 

Creates  the  TCB  for  the  SIP  task  and  reads  the  task  image  off 
of  the  RXOl  into  memory. 

OTL>MM: [1,54]TKN 

Creates  the  TCB  for  the  TKN  task  and  reads  the  task  image   off 
of  the  magnetic  tape  into  memory.   TKN  is  renamed  to  TKTM. 

OTL>PR: 


Creates  the    TCB   for    the   task   on    the   paper    tape      and 
into  memory. 

OTL>CT:TEST.TSK 


reads   it 


Creates  the  TCB  for  the  user-written  task  TEST. TSK 
it  off  of  the  cassette  tape  into  memory. 


and   reads 


2.2.2  Operation  of  OTL 

When  OTL  accepts  a  command  line,  it  first  parses  the  line  for  proper 
syntax.  If  the  syntax  is  correct,  OTL  determines  whether  the 
designated  device  was  generated  into  the  system  as  a  load  device.  If 
it  was,  the  device  is  attached,  and  for  all  devices  except  PR:,  a 
search  is  performed  to  locate  the  designated  file. 
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When  OTL  finds  the  file,  it  reads  the  first  block  of  the  file  and 
checks  to  determine  whether  the  file  is  a  valid  task  image.  If  these 
checks  are  successful,  OTL  proceeds  to  install  and  fix  the  task  or 
common  block.   This  procedure  favolves  several  steps: 

1.  Allocating  and  initializing  a  Task  Control  Block  (TCB)  if  the 
image  is  a  task 

2.  Verifying  that  the  designated  partition  is  in  the  system  and 
is  available 

3.  Finding  space  in  a  system-controlled  partition  (mapped  system 
only)  and  allocating  a  subpartition  PCS 

4.  Reading  and  initializing  the  task's  header 

5.  Loading  the  overlay  segments   into  memory   (memory-resident 
overlaid  tasks) 

6.  Allocating  and  initializing  a  copy  of  the   header   in   the 
Executive's  pool  space  (if  the  system  is  mapped) 

7.  Loading  the  task  or  common  block  into  memory 

8.  Inserting  the  TCB  into  the  System  Task  Dire*  tory  if  the  image 
is  a  task 

Concurrent  with  these  activities,  OTL  performs  additional  validity 
checks. 


2.2.3  Progranming  Hints 

Except  for  the  /INC  Keyword,  OTL  does  not  accept  any  keyword  input,  so 
you  must  explicitly  specify  all  other  attributes  and  options  for  a 
task  when  it  is  built.  (The  task  must  be  built  before  OTL  can  load 
it.)  It  is  particularly  important  to  specify  the  partition  and  task 
name  during  the  option  input.  If  a  task  name  is  not  specifiod  in  the 
task  image,  OTL  defaults  the  task  name  to  the  file  name  in  the  command 
line.  This  default  also  occurs  with  paper  tape,  for  which  no  file 
name  is  required. 

Tasks  installed  by  OTL  cannot  have  disk  overlays  or  be  checkpointable. 
An  attempt  to  install  a  disk-overlaid  task  results  in  an  error  message 
and  a  failure  to  install  the  task.  OTL  ignores  the  checkpoint 
attribute  and  installs  all  checkpointable  tasks  as  noncheckpointable. 
Tasks  with  memory-resident  overlays,  however,  can  be  installed  with 
OTL.  (See  the  RSX-llM/M-PLUS  Task  Builder  Manual  for  more  information 
on  the  different  kinds  of  tasks.) 

OTL  Jlso  supports  tasks  with  memory-resident  overlays  that  link  to 
commons.   You  link  the  task  with  the  common  at  task-build  time. 

OTL  uses  various  methods  to  load  tasks  and  common  blocks  into  memory. 
These  methods  are  described  in  the  following  paragraphs. 

With  task-controlled  partitions,  OTL  fixes  in  memory  each  task  or 
common  block  that  it  installs  and  marks  the  partition  busy.  OTL 
signals  an  error  if  an  attempt  is  made  to  install  a  task  In  an 
occupied  main  partition  or  subpartition,  in  a  subpartition  whose  main 
partition  is  occupied,  or  in  a  main  partition  that  has  an  occupied 
subpartition.  (When  a  task  is  removed  by  means  of  Basic  MCR,  the 
task's  partition  is  no  longer  busy.) 
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With  system-controlled  partitions,  OTL  searches  for  sufficient 
contiguous  memory  into  which  it  can  load  the  task.  OTL  dynamically 
creates  a  subpartition  for  the  memory  it  has  allocated  for  the  task 
and  marks  the  subpartition  busy.  The  subpartition  PCB  is  linked  into 
the  PCB  list. 

When  loading  common  blocks,  on  the  other  hand,  OTL  ignores  the 
partition  state.  Thus,  you  can  overwrite  previously  loaded  common 
blocks  when  desired.  Furthermore,  common  main  partitions  and 
subpartitions  can  be  occupied  concurrently.  This  feature  allows  you 
to  install  casks  with  different  access  privileges  to  different  parts 
of  a   ommon  main  partition. 

For  example,  in  Figure  2-1,  the  main  partition  (COMM)  is  composed  of 
three  subpartitions  (CI,  C2,  C3) .  The  main  partition  and  each  of  its 
subpartitions  have  associated  access  rig'its.  You  can  install  a  task 
with  access  to  the  main  partition,  or  to  one  or  more  subpartitions.  A 
task  installed  with  access  to  COMM  has  Read-Write  (RW)  access  rights 
to  the  entire  main  partition.  A  task  installed  with  access  to  CI  has 
Read-Only  (RO)  access  rights  only  to  that  subpartition. 


main 

pa  r  t  i  t  i  o 

COMM, 

with  RW 

access 

rights 


"I 


>  subpartition  CI  with  RO  access  rights 

>  subpartition  C2  with  RW  access  rights 
f   subpartition  C3  with  RO  access  rights 


Figure  2-1   Relationship  of  Access  Rights  to  Main  Partition 

and  Its  Subpartitions 

When  writing  task  image  files  to  cassette  tape  by  means  of  FLX,  you 
rust  use  a  block  size  (specified  with  the  /BS  switch)  that  evenly 
divides  into  512(10)  bytes.  The  default  block  size  of  128(10)  bytes 
is  compatible  with  this  requirement.  Atte^nptlng  to  install  a  task 
image  from  cassette  tape  with  a  block  size  that  does  not  evenly  divide 
into  512  results  in  an  error  message  and  terminates  the  operation. 

For  more  information  on  building  and  loading  tasks,  refer  to  the 
RSX-llM/M-PLUS  Task  Builder  Manual  and  the  RSX-llM/M-PLUS  Executive 
Reference  Manual . 


2.2.4  OTL  Error  Messages 

When  OTL  detects  an  error  condition,  it  aborts  its  current  operation, 
displays  an  error  message  at  the  terminal  from  which  it  was  activated, 
and  prompts  for  another  command  line.  If  the  detected  error  condition 
is  NO  POOL  SPACE,  OTL  may  immediately  exit  because  printing  the  error 
message  also  requires  pool  space. 

You  can  assemble  OTL  with  long  or  short  error  messages.  Long  error 
messages  identify  OTL  as  the  source  of  the  message  and  give  both  a 
numeric  error  code  and  an  ASCII  description  of  the  error  condiu  on. 
Short  error  messages  exclude  the  ASCII  description,  thus  conserving 
memory  space.  As  distributed,  OTL  assembles  with  short  error 
messages.  For  information  on  assembling  OTL  with  long  error  messages, 
see  Section  4.5.1.3. 
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OTL  generiites  the  follrwing  error  messages,  which  are  shown  in  their 
long  form.  (In  the  short  form,  only  the  task  name  and  error  code 
number  are  displayed.) 

OTL  —  2  -  SYNTAX  ERROR 

A  command  was  entered  with  improper  syntax. 

OTL  ~  3  -  NO  POOL  SPACE 

Upon  issuing  an  I/O  request  or  attempting  to  allocate  pool  space, 
OTL  detected  a  condition  of  insufficient  pool  space  in  the 
Executive.  When  this  error  condition  occurs,  OTL  may  exit 
without  printing  this  error  message. 

OTL  —  5  -  DEVICE  NOT  IN  SYSTEM 

A  device  not  generated  into  the  current  RSX-llS  system  was 
specified  in  the  command  line. 

OTL  —  7  -  PARTITION  NOT  IN  SYSTEM 

The  partition  specified  in  the  task  image  was  not  defined  in  the 
system.  Alternatively,  the  specified  partition  was  defined,  but 
all  or  part  of  its  memory  was  not  present  in  the  current 
configuration. 

OTL  —  8  -  10  ERROR 

A  hardware  error  was  encountered  as  the  result  of  an  I/O  request 
issued  to  the  load  device  or  terminal;  ox.  the  specified  device 
was  generated  into  the  system,  but  it  was  not  present  in  the 
hardware  configuration. 

OTL  —  40  -  BASE  ADDRESS  MUST  BE  ON  A  4K  BOUNDARY 

A  task  image  (not  a  common  block)  in  a  mapped  system  specified  a 
base  address  not  on  a  4K  boundary. 

OTL  —  41  -  ILLEGAL  1ST  APR 

The  image  of  a  nonpr ivileged  task  in  a  mapped  system  specified  a 
nonzero  first  APR,  or  the  image  of  a  privileged  task  in  a  mapped 
jystem  specified  a  first  APR  that  was  not  in  the  range  APR4 
through  APR6. 

OTL  ~  42  -  NOT  ENOUGH  APRS  FOR  TASK  IMAGE 

There  are  not  enough  APRs  to  map  the  task  and  all  resident 
library  references  it  may  have  had  in  a  mapped  system. 

OTL  ~  43  -  FORMATTED  BINARY  CHECKSUM  ERROR 

A  checksum  error  was  encountered  while  reading  a  task  image  fror. 
paper  tape. 
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OTL  ~  44  -  FORMATTED  BINARY  FORMAT  ERROR 

An  invalid  binary  format  was  encountered  in  a   task   image  being 
read  from  paper  tape. 

OTL  —  4  5  -  UNEXPECTED  END  OF  FILE  ENCOUNTERED 

An  end-of-file  was  encountered  before  the  entire  task  image  was 
read . 

OTL  ~  46  -  SPECIFIED  PARTITION  TOO  SMALL 

The  partition  specified  in  the  task  image  was  smaller  than  the 
load  size  of  the  task  or  common  block. 

OTL  —  47  -  SPECIFIED  PARTITION  FOu  COMMON  BLOCK 

An  attempt  was  made  to  install  a  task  into  a  commor  p.  tltion. 

OTL  —  48  -  TASK  IS  OVERLAID 

This  message  is  returned  by  two  conditions: 

1.  An  attempt  was  made  to   install   an  overlaid   task   in   a 
system  without  memory  management  directives. 

2.  An  attempt   was  made   to   install   a   task   that   has 
disk-resident  overlays. 

OTL  —  49  -  TASK  NAME  ALREADY  IN  USE 

An  attempt  was  made  to  install  a  task  with  the  same  name  as  that 
of  a  task  already  installed. 

OTL  —  50  -  TASK  NAME  NOT  DEFINED 

An  attempt  was  made  to  install  a  task  from  paper  tape  without  an 
optional  file  name  specified,  3nd  no  task  name  was  specified  when 
the  task  was  built.  Reenter  the  command,  specifying  a  file  name 
that  will  become  the  task  name  '-^v  default. 

OTL  —  51  -  TASK  AND  PARTITION  BASES  MISMATCH 

An  attempt  was  made  to  install  a  task  in  an  unmapped  system  whose 
base  address  did  not  match  that  of  its  specified  partition. 

OTL  ~  52  -  INVALID  COMMON  BLOCK 

A  task  contained  a  librar"  .eference  to  a  common  block  that  was 
not  in  the  system. 
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OTL  —  53  -  PARTITION  TOO  LARGE  FOR  PRIVILEGED  TASK 

An  attempt  was  made  to  install  a  privileged  task  in  a  partition 
whose  size  was  greater  than  12K  words.  (This  message  occurs  only 
on  unmapped  systems.) 

OTL  —  54  -  FILE  NOT  FOUND 

The  specified  file  was  not  found. 

OTL  —  55  -  COMMON  BLOCK  IS  TASK  PARTITION 

A  task  image  contained  a  library  reference  whose  name  matches 
that  of  a  task  partition. 

OTL  —  56  -  COMMON  BLOCK  NOT  LOADED 

A  task  image  contained  a  library  reference  to  a  common  partition 
that  was  not  loaded. 

OTL  —  57  -  LENGTH  MISMATCH  COMMON  BLOCK 

A  task  image  contained  a  library  reference  to  a  common  block  that 
was  smaller  than  the  size  specified  when  the  task  was  built. 

OTL  --  58  -  BASE  MISMATCH  COMMON  BLOC 

A  task  image  contained  a  library  reference  to  a  common  block 
whose  base  address  was  different  from  the  one  specified  when  the 
task  was  built. 

OTL  —  59  -  COMMON  BLOCK  PARAMETER  MISMATCH 

A  task  image  contained  a  library  reference  to  a  common  block  that 
was  expected  to  contain  position-independent  code,  but  that  did 
not;  or  a  task  image  contained  a  library  reference  to  a  common 
block  that  was  not  expected  to  contain  position-independent  code, 
but  that  did;  or  an  attempt  was  made  to  load  a  common  block 
whose  task  name  did  not  match  the  partition  name. 

OTL  —  60  -  PARTITION  NOT  COMMON 

An  attempt  was  made  to  install  a  common  block  in  a  task 
partition. 

OTL  —  61  -  ILLEGAL  DEVICE 

A  task  image  contained  a  logical  unit  number  (LUN)  assignment  to 
a  device  that  was  not  in  the  system. 

OTL  —  62  -  FILE  NOT  TASK  IMAGE 

Preliminary  checks  indicated  that  the  specifief*,  file  was  not  a 
task  imace,  or  that  the  file  was  corrupted. 
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OTL  —  63  -  PARTITION  IS  BUSY 

An  attempt  was  made  to  fix  a  task  in  a  main  partition  or 
subpartition  that  was  occupied;  to  fix  a  ta'k  in  a  main 
partition  that  had  an  occupied  subpartition;  to  fix  a  task  in  a 
subpartition  that  had  an  occupied  main  partition;  or  to  load  a 
task  into  a  system-controlled  partition,  but  the  partition  did 
not  have  enough  contiguous  memory. 

OTL  ~  65  -  INVALID  BLOCK  SIZE  ON  LOAD  DEVICE 

A  task  image  file  on  cassette  tape  had  a  block  size  that  did  not 
evenly  divide  into  512(10). 

OTL  —  66  -  FILE  NAME  REQUIRED 

No  file  name  was  specified  with  a  device  for  which  a  file  name 
was  required. 

OTL  —  67  -  INVALID  LOAD  DEVICE 

The  version  of  OTL  in  use  did  not  support  or  was  not  assembled  to 
support  the  specified  device. 

OTL  —  68  -  TO''  MANY  WINDOW  BLOCKS 

The  task  would  require  mors  than  8  APRs. 

OTL  ~  69  -  TASK  BUILT  FOR  WRONG  SYSTEM 

OTL  has  determined  that  the  task  requires  features  that  the 
system  does  not  support.  The  task  was  built  for  an  RSX-llM-PLUS 
system  or  the  wrong  version  of  the  Task  Builder  was  used  to  build 
the  task.  (For  memory-resident  overlaid  tasks,  the  version  must 
be  RSX-llM  V3.2  or  greater.) 

OTL  —  70  -  ILLEGAL  USE  OF  INCREMENT 

This  message  is  returned  by  two  conditions: 

1.  The  specified  increment  causes  the  task  to  exceed  32K. 

2.  An  attempt  was  made  to  install  and  fix  an  overlaid  task 
with  an  increment.  Overlaid  tasks  cannot  be  loaded  with 
an  increment. 


2.3   SYSTEM  IMAGE  PRESERVATION  PROGRAM 

The  RSX-llS  System  Image  Preservation  (SIP)  program  saves  RSX-llS 
systems  on  a  load  device  medium  and  writes  the  boot  block.  The  format 
of  these  system  images  on  all  media,  except  paper  tape,  is  a  bootstrap 
block,  a  label  block,  and  a  system  image.  For  paper  tape,  the  format 
is  a  system  image  in  absolute  loader  format,  but  there  is  no  bootstrap 
or  label  block. 
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PCll  paper  tape  punch  (PP)  —  (in  absolute  loader  format) 

RXll  flexible  disk  (DX) 

RX211  flexible  disk  (DY) 

TAll  cassette  tape  (CT) 

TCll  DECtape  (DT) 

TM/TMA/TMBll  magnetic  tape  (MT) 

TM02/TU16-45  magnetic  tape  (MM) 

See  Section  4.5.1.4  for  information  on  building  the  SIP  task. 


2.3.1   Initiating  SIP 

To  use  SIP  in  an  RSX-llS  system,  you  must  install  and  fix  in  memory 
both  SIP  and  Basic  MCR,  the  latter  by  using  VMR  on  the  host  system. 
SIP  may  be  installed  and  fixed  in  the  system  by  VMR,  by  OTL  running  on 
the  RSX-llS  system,  or  by  down-line  loading  with  DECnet.  You  initiate 
SIP  by  typing  the  following  Basic  MCR  command: 

>RUN  SIP 

SIP  then  begins  execution  and  indicates  its  readiness  to  accept  a 
command  line  by  prompting  with: 

SIP> 

To  exit  from  SIP,  you  must  type  the  CTRL/Z  character  (by  holding  down 
the  CTRL  key  and  pressing  the  Z  key).  SIP  command  lines  have  the 
following  format: 

SIP>dev:label 

dev: 

The  load  device  unit  to  receive  the  system  image.  There  is  no 
default  for  dev:;   it  must  be  specified. 

label 

The  label  to  be  associated  with  the  system  image.  It  consists  of 
from  one  to  a  maximum  of  twelve  alphanumeric  characters.  The 
label  must  be  specified  for  all  devices  except  paper  tape,  for 
which  it  is  i.qnored. 

Blanks  and  tabs  are  not  allowed  in  a  SIP  command  line. 
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Examples: 

SIP>MM:RSX11S 

Saves  the  RSXllS  system  image  on  a  magnetic  tape. 
SIP>PP: 

Saves  the  system  image  on  a  paper  tape. 

SIP>DT1:11SMAPPEDSYS 

Saves  the  system  image  on  a  DECtape.  Another  file  name  is 
used  to  distinguish  between  different  versions  of  the  system 
image  on  the  DECtape. 


2.3.2  Operation  of  SIP 

When  SIP  accepts  a  command  line,  it  performs  the  following  actions  if 
no  error  conditions  are  encountered: 

1.  Parses  the  line  for  proper  syntax  and  creates  a  label  block. 

2.  Determines  whether  the  designated  device  was  generated  into 
the  current  system  as  a  load  device. 

3.  Makes  sure  that  there  is  no  outstanding  I/O  in  the  system. 

4.  Attaches  the  device,  rewinds  it  (if  cassette  tape  or  magnetic 
tape),  and  outputs  the  boot  and  label  blocks  (if  not  paper 
tape) . 

5.  Outputs  the  system  image  at  processor  priority  level  PR7.  If 
the  output  device  is  the  paper  tape  punch,  the  system  image 
is  output  in  absolute  loader  format. 

6.  Returns  the  processor  priority  to  PRO  and  prompts  for  another 
command  line. 

The  subsequently  produced  system  image,  with  the  exception  of  paper 
tape,  may  be  bootstrapped  directly  with  an  appropriate  hardware 
bootstrap.  To  boot  a  paper  tape  image,  the  absolute  loader  must  first 
be  bootstrapped  by  means  of  the  paper  tape  bootstrap.  You  can  then 
bootstrap  the  paper  tape  produced  by  SIP  with  the  absolute  loader. 


2.3.3  Hints  on  Using  SIP 

In  general,  any  system  saved  by  SIP  on  a  device  other  than  paper  tape 
can  be  booted  on  another  system  with  a  different  amount  of  memory. 
The  only  requirement  is  that  when  you  are  transporting  the  saved 
system  to  a  smaller  system,  the  top  of  memory  cannot  be  lower  than  the 
physical  top  of  SIP's  task  image  in  the  saved  system. 

To  further  enhance  system  transportability,  a  system  saved  on  a 
TM/TMA/TMBll  9-track  magnetic  tape  drive  in  800  bpi  mode  can  be 
bootstrapped  from  a  TU16  drive,  and  vice  versa. 

The  maximum  memory  size  that  can  be  saved  is  124K  words.  For  physical 
and  practical  limitations,  SIP  imposes  maximum  sizes  on  saved  images 
in  mapped  systems  for  certain  devices.   If  a  mapped   system   is  saved 
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whose  memory  size  Is  greater  than  the  maximum  size  imposed  by  SIP  for 
the  specified  device,  only  the  amount  of  memory  equal  to  the  maximum 
size  and  starting  at  physical  location  0  is  saved;  no  diagnostic  is 
issued.  The  devices  for  which  SIP  imposes  a  maximum  size  on  saved 
system  images  are: 

PC  11  paper  tape  punch  (PP)  —  28K  words 

RXll  flexible  disk  (DX)  --  122K  words 

RX211  flexible  disk  (DY)  --  122K  words  for  single-density  disk 

TAll  cassette  tape  •     —  28K  words 

SIP  determines  the  amount  of  memory  to  be  saved  by  examining  the 
location  SSYSIZ  in  the  Fxecutive  module  SYSCM.  This  location  is  set 
to  the  size  of  physical  memory  (in  32-word  blocks)  when  the  system  is 
bootstrapped.  You  can  reduce  the  size  of  the  saved  system  by  placing 
the  desired  value  in  this  location  when  the  system  is  not  being  used 
otherwise,  and  restoring  the  otiginal  value  after  the  system  is  saved. 

Certain  restrictions  mjst  be  enforced  when  you  are  not  saving  all  of 
physical  memory.  SIP  must  be  fixed  entirely  in  the  saved  area  or  the 
system  will  not  reboot  properly.  Tasks  that  are  fixed  in  memory 
outside  of  the  saved  area  cannot  be  run  when  the  system  is  rebooted. 
It  is  advisable  to  remove  all  «jch  tasks  prior  to  saving  the  system. 

When  a  system  is  saved  on  paper  tape,  the  last  300(8)  bytes  of  the 
system  image  are  not  output;  this  is  done  to  accommodate  the  absolute 
loader.  Unmapped  systems  and  mapped  systems  smaller  than  28K  words  of 
memory  that  are  saved  on  paper  tape  must  be  booted  on  a  configuration 
having  at  least  the  same  amount  of  memory.  Mapped  systems  larger  than 
28K  words  that  are  saved  on  paper  tape  (of  which  only  the  first  28K 
words  of  the  system  image  is  saved)  must  be  booted  on  a  configuration 
having  at  least  28K  words  of  memory.  These  restrictions  are  necessary 
to  prevent  the  absolute  loader  from  overwriting  itself. 

When  booting  from  paper  tape,  the  absolute  loader  halts  if  it 
encounters  a  checksum  error.  The  absolute  loader  retries  the  read  if 
the  paper  tape  is  backed  up  to  a  previous  interblock  gap,  and  the 
CONTINUE  switch  on  the  processor  console  panel  is  pressed.  Interblock 
gaps  appear  on  the  tape  as  a  group  of  at  least  4  nulls,  followed  by  a 
1,  followed  by  another  null.  The  tape  should  be  positioned  in  the 
group  of  nulls.  If  the  absolute  loader  encounters  a  hardware  error  on 
the  paper  tape  reader,  you  must  restart  the  loader. 


2.3.4  SIP  Error  Messages 

When  SIP  detects  an  error  condition,  it  aborts  its  current  operation, 
displays  an  error  message,  and  prompts  for  another  command  line.  The 
single  exception  to  this  procedure  results  from  a  condition  of 
insufficient  pool  space  in  the  Executive.  In  this  case,  SIP 
immediately  exits  because  displaying  an  error  message  requires 
additional  pool  space.  When  an  I/O  error  occurs  while  booting  a 
system  saved  by  SIP  from  a  device  other  than  paper  tape,  a  "BR  ." 
(branch  to  the  same  location)  instruction,  or  its  equivalent,  is 
executed,  causing  the  CPU  to  enter  a  closed  loop;  subsequently,  all 
I/O  is  stopped. 

You  can  assemble  SIP  with  long  or  short  error  messages.  Long  error 
messages  identify  SIP  as  the  source  of  the  message  and  give  both  a 
numeric  error  code   and   a  brief   ASCII   description  of   the  error 
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condition.  Short  error  messages  exclude  the  ASCII  description,  thus 
conserving  memory  space.  As  distributed,  SIP  assembles  with  short 
error  messages.  Section  4.5.1.4  describes  the  steps  necessary  to 
assemble  SIP  with  long  error  messages. 

SIP  generates  the  following  error  messages.  Each  message  is  followed 
by  a  brief  description  of  its  possible  causes.  The  error  messages  are 
shown  in  their  long  form. 

SIP  ~  2  -  SYNTAX  ERROR 

A  command  was  entered  with  improper  syntax. 

SIP  —  5  -  DEVICE  NOT  IN  SYSTEM 

A  device  that  was  not  generated  into  the  system  was  specified  in 
the  command  line. 

SIP  —  8  -  10  ERROR 

A  hardware  error  was  encountered  as  the  result  of  an  I/O  request 
issued  to  the  load  device  or  the  terminal;  or  the  specified 
device  »-as  generated  into  the  system,  but  it  was  not  present  in 
the  configuration. 

SIP  —  66  -  LABEL  REQUIRED 

No  label  was  specified  with  a  device  for  which  one  was  required. 

SIP  ~  67  -  INVALID  LOAD  DEVICE 

The  version  of  SIP  in  use  did  not  support  or  was  not  assembled  to 
support  the  specified  device  as  a  load  device. 

SIP  —  68  -  10  OUTSTANDING 

An  attempt  was  made  to  save  the  system  at  a  time  when  one  or  more 
tasks  had  I/O  outstanding. 


2.4   TASK  TERMINATION  NOTIFICATION  PROGRAM 

The  Task  Termination  Notification  program  (TKTN)  outputs  abnormal  task 
termination  and  device  status  information. 

If  a  task  aborts,  TKTN  prints  on  the  task's  initiating  terminal  the 
notification  and  appropriate  error  message.  TKTN  also  displays  the 
contents  of  the  task's  registers  at  the  time  the  task  aborted. 

If  a  task  aborts  with  I/O  requests  outstanding,  the  error  message  will 
include  the  phrase  "and  with  pending  I/O  requests." 

All  task  abort  messages  are  printed  or  displayed  at  the  initiating 
terminal.  All  other  TKTN  messages  are  printed  on  the  console 
terminal . 
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The  messages  printed  on  the  console  terminal  generally  identify  error 
and  status  conditions  relating  to  the  system. 

See  Section  4.5.1.1  for  information  on  building  the  TKTN  program. 


2.4.1   Initiating  TKTN 

TKTN  is  activated  by  the  Executive  when  a  task  terminates  abnormally 
or  when  a  device  driver  wants  to  report  unusual  status  information. 
Use  VMR  to  install  and  fix  TKTN  in  the  system  during  the  RSX-llS 
system  generation. 


2.4.2  TKTN  Error  Messages 

TKTN  generates  the  following  error  messages  in  an  RSX-llS  system.  In 
this  section,  each  er  or  message  is  followed  by  a  brief  description  of 
the  probable  cause. 

Error  messages  that  are  related  to  devices  are  preceded  by  the  device 
miemonic,  rep.esentt.d  here  by  "ddnn:". 

Error  messages  that  are  related  to  task  termination  will  include  a 
display  of  the  contents  of  the  task's  registers  at  the  time  of 
termination.  These  are  represented  here  by  the  "(registers)" 
notation. 

Task-related  error  messages: 

TASK  "taskname"  TERMINATED  —  ODD  ADDRESS  OR  OTHER  TRAP  FOUR 
(registers) 

The  task  executed  a  word  instruction  with  an  odd  address  or 
referenced  a  nonexistent  memory  location  in  an  unmapped  system, 
and  no  SST  routine  was  specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  —  MEMORY  PROTECT  VIOLATION  (registers) 

The  task  encountered  a  memory  protect  violation  and  no  SST 
routine  was  specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  ~  T-BIT  TRAP  OR  BPT  EXECUTION  (registers) 

The  task  has  either  set  the  T-bit  in  the  Processor  Status  Word  or 
executed  a  Breakpoint  Trap  instruction,  and  no  SST  routine  was 
specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  —  lOT  EXECUTION  (registers) 

The  task  executed  an  lOT  instruction  and  no  SST  routine  was 
specified  to  process  the  trap. 
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TASK  "taskname"  TERMINATED  —  RESERVED  INST  EXECUTION  (leqisters) 

The  task  executed  an  illegal  instruction  and  no  SST  routine  was 
specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  —  NON-RSX  EMT  EXECUTION  (registers) 

The  task  executed  an  EMT  Instruction  having  an  argument  other 
than  377(8)  and  no  SST  routine  was  specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  --  11/40  P.P.  EXCEPTION  (registers) 

The  task  encountered  a  floating  point  exception  while  executing 
on  a  PDP-11/40  and  no  SST  routine  was  specified  to  process  the 
trap. 

TASK  "taskname"  TERMINATED  —  TRAP  EXECUTION  (registers) 

The  task  executed  a  TRAP  instruction  and  no  SST  routine  was 
specified  to  process  the  trap. 

TASK  "taskname"  TERMINATED  —  SST  ABORT.  BAD  STACK  (registers) 

An  SST  Tannot  be  effected  because  the  SST  parameters  cannot  be 
pushed  onto  the  task's  stack,  or  a  stack  overflow  was  detected  in 
an  unmapped  system,  as  indicated  by  ?  nonzero  value  in  the  header 
guard  word. 

TASK  "taskname"  TERMINATED  —  AST  ABORT.  BAD  STACK  (registers) 

An  AST  cannot  be  effected  because  the  AST  parameters  cannot  be 
pushed  onto  the  task's  stack. 

TASK  "taskname"  TERMINATED  —  ABORTED  VIA  DIRECTIVE  OR  CLI 

Either  an  Executive  directive  or  a  CLI  command  issued  by  another 
task  caused  the  task  to  be  aborted. 

TASK  EXIT  WITH  OUTSTANDING  I/O  (registers) 

The  task  terminated  before  all  of  its  I/O  was  completed. 
This  is  only  a  warning  message. 

PARITY  ERROR  (registers) 

A  parity  error  occurred  during  task  execution.  The  task  is  fixed 
in  memory  so  that  the  memory  cannot  be  reused  for  another  task. 

Device-rela»-*fd  messages: 

•*•    ddnn:   NOT  READY 

The  opacified  device  was  not  ready. 
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*♦*    ddnn:   SELECT  ERROR 

The  selected  device  was  not  ready  or  more  than  one  drive  had  the 
same  unit  number. 

« 

**•    ddnn:   DliSMOUNT  COMPLETE 

This  is  an  informative  message.  It  Indicates  that  the  device 
requested  for  dismount  is  now  logically  disconnected  from  the 
system  (that  is,  all  files  are  deaccessed  and  the  VCB  is 
deallocated) . 

MICRO  CODE  LOADER  NOT  INSTALLED 

This  message  is  associated  with  KMC-controlled  line  printers.  A 
system  that  includes  the  KMCll  driver  (LKDRV)  has  been  generated 
but  the  LPINIT  task  has  not  been  installed. 


2.5      SETTIM 

SETTIM  is  a  TORTRAN-callable  subroutine  used  to  set  the  system's 
int.3fnal  time.  It  is  supplied  to  allow  a  running  program  to  set  the 
time  in  a  configuration  that  does  not  include  a  console  terminal 
and/or  Basic:  MCR.  The  module  is  included  in  a  user  task  by  linking 
with  the  file  SETTIM. OBJ,  which  resides  under  UFD  [l,2u]  for  unmapped 
systems  or    [1,24]    for   mapped    systems. 

The    format   of   the   FORTRAN  call    is   as   follows: 

CALL  SETTIM    (itime) 

The  variable  itime  is  an  8-word  integer  array  containing  the  time. 
The  contents  of  the  array  are  used  in  the  following  order: 

Year  (since  1900) 

Month  (1-12) 

Day  (1-31) 

Hour  (0-23) 

Minute  (0-59) 

Second  (0-59) 

Tick  of  second  (depends  on  clock  frequency) 

Ticks  per  second  (depends  on  clock  frequency) 

Complete  error  checking  occurs  to  ensure  that  the  specified   date   and 

time  are  legdl,  but  no  errors  are  returned  to  the  calling  program.   If 

an  error  is  detected,  the  date  or  time  is  not  changed.   Calls  made 

without  an  array  specified  simply  return. 

SETTIM  can  also  be  called  with  a  6-word  array  by  omitting  the  entries 
for  tick  of  second  and  ticks  per  second.  These  two  entries  default  to 
the  values  previously  set  for  them. 

See  Section  4.5.1.5  for  information  on  generating  the  SETTIM  routine. 
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2.6   SYSTEM  ACTIVITY  DISPLAY  PROGRAMS 

RSDV05,  RSDV52,  and  RSDVIH  (referred  to  in  this  section  as  RSD)  are 
privileged  tasks  that  display  information  concerning  task  activity  in 
an  RSX-llS  system.  You  can  invoke  and  continually  run  these  tasks  on 
a  VT05B  video  terminal,  a  VT52  video  terminal,  and  a  VTIOO  video 
terminal,  respectively.  The  display  format  is  similar  to  that  of  the 
RMDEMO  display,  which  is  described  in  the  RSX-llM/M-PLUS  System 
Management  Guide. 

RSD  running  on  RSX-llS  requires  approximately  6K  words. 

The  display  features  include: 

•  Current  date  and  time 

•  The  currently  active  task 

•  All  tasks,  loaded  drivers,  and  common  blocks  currently  in 
memory,  displayed  in  a  graphic  fashion  to  show  their 
individual  memory  requirements  and  locations  relative  to  other 
tasks 

•  The  number  of  active  tasks  currently  in  memory  and  the  total 
amount  of  memory  occupied  by  each  task 

•  The  current  amount  of  available  system  dynamic  memory  (pool), 
including  the  largest  available  block  and  the  number  of 
fragments;  and  the  worst  case  of  pool  space  since  bringing  up 
RSD  (not  displayed  on  a  VT05B) 

•  A  graphic  display  of  partition  information 

RSD  scales  the  display  to  the  memory  size  of  the  computer  on  which  it 
is  executed.  Graphically,  total  memory  is  represented  in  multiples  of 
32  words.  For  this  reason,  the  display  may  not  always  represent  the 
exact  total  memory  for  the  associated  computer. 

Task  locations  and  sizes  displayed  by  RSD  should  be  considered 
approximate.  RSD  is  primarily  designed  to  provide  a  visual  display 
and  system  debugging  tool.  It  does  not  accurately  measure  task  size 
and  location. 

In  general,  RSD  is  a  useful  task  designed  to  allow  either  an  operator 
or  user  to  view  the  current  state  of  the  operating  system.  The 
information  is  presented  in  a  graphic,  easily  comprehensible  form. 

A  specific  instance  in  which  KSD  can  help  you  is  to  locate  certain 
system  lockout  problems  or  bugs  in  application  and/or  system-level 
software.  You  can  detect  and  more  easily  reproduce  bugs  and  other 
situations  that  cause  exhaustion  of  pool  (resulting  in  unexplained 
system  hangs) . 

See  Section  4.5.1.6  for  information  on  building  the  RSD  tasks. 
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2.7   FILE  CONTROL  SERVICES 

RSX-llS  does  not  have  its  own  file  system,  but  it  does  support  a 
subset  of  the  RSX-llM  File  Control  Services  (PCS)  that  perforins  basic 
record  I/O.   The  RSX-llS  FCS  subset  does  not  support  the  following: 

•  File-structured  devices  (Files-11  disk  and  ANSI  magnetic  tape) 

•  Block  I/O  operations 

•  Random  access  record  I/O 

•  Sequenced  records 

All  of  the  RSX-llM  FCS  calls  are  present  in  the  RSX-llS  FCS  subset, 
even  though  they  are  not  supported  in  RSX-llS;  a  call  to  an 
unsupported  FCS  routine  results  in  an  immediate  return  to  the  caller 
or  an  error  return.  The  level  of  support  in  each  call  in  RSX-llS  is 
described  in  the  section  that  follows. 

In  general,  the  subset  FCS  handles  I/O  in  the  same  way  that  the 
RSX-llM  FCS  handles  I/O  for  record  I/O  operations.  Minor  exceptions 
to  this  are  not-.ed  in  Section  2.7.1,  which  follows.  Please  note  that  a 
MACRO-11  prograiTimer  must  maintain  the  data  structures  (such  as  FOB  and 
FNB)  as  described  in  the  IAS/RSX-11  I/O  Operations  Reference  Manual. 

Section  2.7.1  describes  the  macro  calls  used  to  process  files  and 
Section  2.7.2  describes  the  file  control  routines.  All  of  the  calls 
and  routines  are  fully  documented  in  the  IAS/RSX-11  I/O  Operations 
Manual . 


2.7.1  File-Processing  Macro  Calls 

The  file-processing  macro  calls  are  used  to  manipulate  files.  With 
them,  you  can  open,  read,  and  write  files.  The  following  sections 
describe  these  macro  calls. 


2.7.1.1  OPEN$x  -  Generalized  OPEN  Macro  Call  -  Although  RSX-llS  does 
not  support  a  file  system,  the  concept  of  file  I/O  is  still 
applicable.  Before  you  can  transfer  any  data,  you  must  open  a  file. 
This  procedure  has  been  greatly  simplified  by  the  exclusion  of 
directory-structured  devices.  In  general,  the  OPEN$x  macro  calls 
perform  as  they  do  for  record  devices  under  standard  FCS. 

When  FCS  opens  a  file,  it  takes  a  number  of  steps  to  identify  a  file 
name.  The  FCS  subset  has  reduced  this  procedure  to  a  single  step.  Of 
the  three  fields  in  the  file  descriptor  (device,  directory,  and  file 
name),  only  the  device  string  is  significant,  and  it  is  parsed  as 
usual.  The  directory-string  field  is  ignored;  the  MFD  is  always 
assumed.  The  file  name  string  is  always  ignored.  As  a  result,  all 
error  status  returns  regarding  the  latter  two  fields  are  eliminated. 

Because  RSX-llS  does  not  support  a  directory  structure,  there  is  no 
need  to  search  the  MFD  and  UFD.   File-IDs  are  always  forced  to  be  1. 
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2.7.1.2  OPNSSx  -  Open  File  for  Shared  Access  -  File  access  protection 
is  enforced  by  the  file  system  primitives.  Because  RSX-llS  Joes  not 
support  a  file  system,  all  files  are  implicitly  opened  ior  shared 
access. 


2.7.1.3  OPNT$W/OPNT$D  -  Create  and  Open  Temporary  Files  -  The  feature 
of  temporary  files  is  based  upon  creating  a  file  that  does  not  have  a 
directory  entry  associated  with  it.  Such  is  the  case  for  all  file 
operations  in  this  subset  FCS. 


2.7.1.4  OFID$/OFNB$  -  Open  by  File-ID/Open  By  Filename  Block  -  All 
file-IDs  are  forced  to  be  1.  Therefore,  no  specific  test  is  performed 
in  OFID$  for  a  file-ID.  This  relaxation  implies  that  the  two  calls 
operate  in  exactly  the  same  way. 


2.7.1.5   OPENS  -  Generalized  Open   for   Specifying   File   Access  -  All 
comments  in  the  four  previous  sections  apply  to  this  call. 


2.7.1.6  CLOSES  -  Close  Specified  File  -  Because  RSX-llS  does  not 
support  record  blocking,  there  are  no  partially  filled  buffers  and 
consequently  no  need  to  empty  them.  Furthermore,  there  is  no  file 
deaccess  because  there  is  no  file  system.  As  a  result,  no  FCS  error 
conditions  are  possible. 


2.7.1.7  GET$x  -  Read  Logical  Hecord  -  The  GETS  and  GETSS  macro  calls 
translate  directly  into  requests  to  read  from  the  device;  there  is  no 
record  unblocking.  However,  the  virtual  block  number  field  (F.VBN)  is 
maintained.  Therefore,  you  may  treat  a  block  device  as  a  record 
device  having  a  direct  translation  of  virtual  block  into  logical 
block.  The  GETSR  macro  call  is  returned  with  an  error  code  of  lE.ISQ 
(illegal  sequential  operation) . 


2.7.1.8  PUTSx  -  Write  Logical  Record  -  The  PUTS  and  PUTSS  macro  calls 
translate  directly  into  requests  to  write  to  the  device;  there  is  no 
record  blocking.  As  with  the  input  operations,  the  virtual  block 
number  is  maintained  in  the  FDB,  allowing  record  I/O  to  block  devices. 
The  PUTSR  macro  call  is  returned  with  an  error  code  of  lE.ISQ  (illegal 
sequential  operation) . 


2.7.1.9  READS,  WRITES,  WAITS  -  Virtual  Block  I/O  -  These  calls  are 
not  applicable  to  record  devices  and  therefore  are  not  supported. 
Attempts  to  use  these  calls  and  to  open  a  file  for  read-write  I/O 
(record  access  parameter  is  FD.RWM)  result  in  the  return  of  an  error 
code  IE. ILL  (illegal  operation). 


2.7.1.10  DELETS  -  Delete  Specified  File  -  Because  RSX-llS  does  not 
maintain  a  file  structure,  the  delete-file  function  is  minimal.  A 
parse  of  the  device  field  is  performed  and  the  file  is  closed  if  it  is 
currently  open. 
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2.7.2  File  Control  Routines 

The  file  control  routines  allow  you  to  make  changes  to  files. 
However,  RSX-llS  does  not  support  all  of  these  routines.  The 
following  sections  describe  each  routine  and,  if  applicable,  explain 
why  it  cannot  be  used  on  RSX-llS. 


2.7.2.1  Default  Directory  String  Routines  -  RSX-llS  does  not  support 
a  directory  structure.  Calls  to  .RDFDR  to  read  the  default  directory 
string  descriptor  always  return  a  zero  in  Rl,  the  size  of  the  string 
in  bytes.  Calls  to  .WDFDR  to  write  the  string  descriptor  result  in  an 
immediate  return. 


2.7.2.2  Default  File  Protection  Word  Routines  -  File  protection  is  a 
function  of  the  file  system,  which  is  not  present  in  RSX-llS. 
Therefore,  calls  to  .RDFFP  to  read  the  default-file-protection  word 
always  return  a  zero  in  Rl.  Calls  to  .WDFFP  to  write  a  new 
default-file-protection  word  result  in  an  immediate  return. 


2.7.2.3  File  Owner  Word  Routines  -  File  owner  information  is 
established  at  file  creation  and  is  relevant  only  to  the  file  system. 
Hence,  calls  to  .RFOWN  to  read  the  file-owner  word  always  return  a 
zero  in  Rl.  Calls  to  .WFCWN  to  write  a  new  file-owner  word  result  in 
an  immediate  return. 


2.7.2.4  ASCII/Binary  UIC  Conversion  Routines  -  The  requirement  to 
maintain  and/oi  establish  UICs  disappears  with  the  absence  of  a  file 
system.  Calls  to  .ASCPP  to  convert  an  ASCII  UIC  string  to  binary 
always  return  a  zero  result  in  the  word  location  whose  address  is 
contained  in  R3.  Calls  to  .PPASC  to  convert  a  binary  UIC 
representation  to  ASCII  always  return  a  null  value  to  the  byte  pointed 
to  by  R2.   Furthermore,  the  contents  of  R2  are  incremented  by  1. 


2.7.2.5  Filanane  Block  Routines  -  Directory  and  file  name  strings  are 
ignored.  As  a  result,  a  call  to  .PARSE  reduces  to  an  examination  of 
the  device  string,  a  LUN  assignment  to  that  device,  and  the 
establishment  of  a  default  directory  ID  of  -1,-1  (the  MFD).  On  the 
other  hand,  calls  to  .PRSDV  (parse  a  device  string)  and  to  .ASLUN 
(assign  a  logical  unit  number)  remain  unaffected. 


2. 7.1?. 6  Directory  Entry  Routines  -  File  directories  are  not  supported 
in  the  subset.  Therefore,  calls  to  .ENTER  (insert  directory  entry), 
.FIND  (locate  directory  entry),  and  .REMOV  (delete  directory  entry) 
reduce  to  a  logical  unit  assignment  and  a  return  with  a  file-ID  of  1. 


2.7.2.7  Directory  Information  Routines  -  Lack  of  directory  structure 
support  also  reduces  the  capability  of  these  routines.  Both  .GTDID 
(insert  default  directory  information  in  file  name  block)  and  .GTDIR 
(insert  directory  information  in  file  name  block)  calls  now  perform 
only  a  LUN  assignment  and  fill  in  the  directory-ID  of  -1,-1. 
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2.7.2.8  File-Positioning  Routines  -  The  call  to  .MARK  (save 
positional  context  of  file)  is  unaffected.  The  .POINT  routine 
(position  file  to  specified  byte)  unconditionally  stores  the 
virtual-block-number  field  for  treating  block  devices  as  though  they 
were  record  devices. 

The  .POSIT  and  . POSRC  routines  are  concerned  with  the  positional 
relationship  of  records  within  a  file.  This  relationship  is  of  use 
only  in  random  access  programming  and  is  not  supported  in  RSX-llS. 
Calls  to  these  routines  return  the  error  code  lE.ISQ  (illegal 
sequential  operation) . 


2.7.2.9  Queue  I/O  Function  Routine  -  This  routine  is  called  to 
execute  a  specified  QUEUE  I/O  function  and  to  wait  for  its  completion. 
The  routine  accepts  parameters  that  include  the  address  of  the  desired 
File  Descriptor  Block  (FDB),  the  desired  QUEUS  I/O  function  code,  and 
optional  parameters  that  are  to  be  included  in  the  QUEUE  I/O 
directive. 


2.7.2.10  Renane-File  Routine  -  The  file-rename  function  is  concerned 
with  entries  in  a  directory  structure.  Because  RSX-llS  does  not 
support  a  directory  structure,  calls  to  .RENAM  produce  the  following 
results.  The  file  whose  FDB  address  is  contained  in  RO  is  closed.  A 
parse  (as  defined  in  Section  2.7.2.5)  is  performed  for  both  FDBs .  No 
additional  checks  are  made. 


2.7.2.11   File-Extension  Routine  -  The  concept  of  extending  a  file  is 

not  applicable   without  the  support  ot  a  file  system.   Therefore,  the 

f51e  extend  routine  .EXTND  simply  parses  the  file  name  (as  defined  in 
Section  2.7.2.5)  if  the  file  is  not  already  open. 


2.7.2.12  File-Deletion  Routines  -  The  delete  by  file  name  block 
routine  .DLFNB  performs  exactly  as  DELET$  (described  in  Section 
2.7.1.10).  The  capability  of  the  call  to  mark  a  file  for  deletion 
(.MRKDL)  automatically  succeeds  if  the  file  is  open.  If  the  file  is 
closed,  the  logical  unit  assignment  is  performed. 


2.7.2.13  Device  Control  Routine  -  The  routine  to  perform 
device-specific  control  functions,  .CTRL,  provides  users  with  a 
control  Interface  to  the  ANSI  magtape  and  Files-11  ACPs.  Because 
neither  of  them  is  supported  on  RSX-llS,  this  routine  returns  an  error 
code  IE. ILL  (illegal  operation). 


2.7.3  Using  the  Subset  FCS 

Users  desiring  the  features  of  subset  FCS  as  a  result  of  either 
explicit  use  of  macro  calls  or  FORTRAN  I/O  should  link  with  the  subset 
object  library  [1 , 1] IISLIB.OLB.  Creating  this  library  is  an  option  in 
the  RSX-llS  SYSGEN  process.  Failure  to  use  this  library  results  in 
the  resolution  of  FCS  code  from  the  host  system  object  library 
(SYSLIB.0L3) .  Not  only  is  that  version  of  FCS  much  larger,  but  it  is 
also  inappropriate  for  use  on  RSX-llS  because  it  requires  interaction 
with  a  file  system  to  service  several  types  of  devices. 
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RSX-llS  DISTRIBUTION  KIT 


3.1  RSX-llS  DISTRIBUTION  MEDIA 

RSX-llS  software  is  distributed  on  a  variety  of  media.  The  release 
kits  available  are: 

1.  Two  RK05  cartridge  disks 

2.  One  RK06  cartridge  disk 

3.  One  RK07  cartridge  disk 

4.  One  RLOl  cartridge  disk 

5.  One  RL02  cartridge  disk 

6.  Three  magnetic  tapes,  9-track,  800  bpi ,  600-foot 

7.  One  magnetic  tape,  9-track,  1600  bpi,  2400-foot 

For  2-volume  kits,  the  first  volume  is  labeled  llSKITl  and  the  second 
volume  is  labeled  11SKIT2.  The  third  tape  in  the  800  bpi  magnetic 
tape  kit  is  labeled  11SKIT3. 

3.2  CONTENTS  OF  THE  RSX-llS  DISTRIBUTION  KIT 

Table  3-1  lists  most  of  the  files  contained  in  the  RSX-llS  release 
kit.  All  files  in  this  table  are  located  in  UFD  [2,20].  Section  3.3 
lists  additional  files  needed  for  generating  an  IIS  system  on  a 
non-RSX-llM  host. 

The  disk  media  are  written  in  Files-11  format  by  the  Peripheral 
Interchange  Program  (PIP).  The  tape  media  are  created  in  DOS  format 
by  the  File  Transfer  Utility  Program  (FLX).  See  the  RSX-llM/H-PLUS 
Utilities  Manual  for  more  information  on  PIP  and  FLX. 
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Table  3-1 
Contents  of  RSX-llS  Distribution  Kits 


File 

Identification 

BM PR E.MAC 

BASMCR  assembly  prefix  file 

ABOBAS.MAC 

BASMCR  source  file 

ATLBAS.MAC 

BASMCR  source  file 

BRKBAS.MAC 

BASMCR  source  file 

ERRBAS.MAC 

BASMCR  source  file 

ERRMSG.MAC 

BASMCR  source  file 

FMTDV.MAC 

BASMCR  source  file 

FNDUCB.MAC 

BASMCR  sourct  file 

GNBLK.MAC 

BASMCR  source  file 

GETNUM.MAC 

BASMCR  source  file 

KEYWD.MAC 

BASMCR  source  file 

LKLST.MAC 

BASMCR  source  file 

MCRBAS.MAC 

BASMCR  source  file 

OPEBAS.MAC 

BASMCR  source  file 

PRSBAS.MAC 

BASMCR  source  file 

REDBAS.MAC 

BASMCR  source  file 

R EM B AS. MAC 

BASMCR  source  file 

RPSBAS.MAC 

BASMCR  source  file 

RUNBAS.MAC 

BASMCR  source  file 

TIMBAS.MAC 

BASMCR  source  file 

OTLPR E.MAC 

OTL  assembly  prefix  file 

OTL.MAC 

OTL  source  file 

OT LCD. MAC 

OTL  source  file 

OTLCM.MAC 

OTL  source  file 

(continued  on  next  page) 
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Table  3-1   (Cont.) 
Contents  of  RSX-llS  Distribution  Kits 


File 

Identification 

OTLERR.MAC 

OTL  source  file 

OTLHD.MAC 

OTL  source  file 

OTLLB.MAC 

OTL  source  file 

OTLLD.MAC 

OTL  source  file 

OTLOIO.MAC 

OTL  source  file 

OTLR D.MAC 

OTL  source  file 

SIPPRE.MAC 

SIP  assembly  prefix  file 

SI  P. MAC 

SIP  source  file 

SIPBOO.MAC 

SIP  source  file 

SI  PCD. MAC 

SIP  source  file 

SIPERR.MAC 

SIP  source  file 

SIPLD.MAC 

SIP  source  file 

SIPQIO.MAC 

SIP  source  file 

TKTN . MAC 

TKTN  source  file 

PCS  lis. OBJ 

Subset  PCS  concatenated  object 
modules 

SETT IM. MAC 

Source  file  of  FORTRAN 
callable  routine  to  set  system 
time 

RMDUNM.OLB 

RMDSMO  object  library  file 
(unmapped  system) 

RMDMAP.OLB 

RMDBMO  object  library  file 
(trapped  system) 

11SGEN.CMD 
11SGBN2.CMD 

RSX-llS  system  generation 

command  files: 

IISGEN  -  Phase  1 
11SGEN2  -  Phase  2 

BLXIOU.OBJ 

Object  file  required  to  build 
OTL  (unmapped  system) 

BLXIOM.OBJ 

Object  file  required  to  build 
OTL  (mapped  system) 
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3.3   ADDITIONAL  FILES  REQUIRED  POR  RSX-llM-PLUS  AND  VAX/VMS  BOST  SYSTEMS 

The  RK05,  RK06/RK07,  RL01/RL02,  and  magnetic  tape  kits  also  contain 
additional  files  to  generate  RSX-llS  on  an  RSX-llM-PLUS  or  VAX/VMS 
host.   The  additional  files  Include  the  following: 

•  Commend  files  to  perform  the  RSX-llS  system  generation 

•  The  RSX-llM  Task  Builder  task  image  file  and  the   RSX-llM   VMR 
task  image  file 

•  Needed  portions  of  system  macro  and  object  libraries 
«   Command  files  to  build  process  control  device  commons 

•  Executive  and  device  driver  source  files 

•  Command  files  and  object  library  to  build  CDA  for  use  on   the 
host  system 

The  command  file  11SC0PY.CMD  copies  all  •the  needed  files  from  the 
distribution  kit  to  your  target  disk  during  Phase  1  of  the  system 
generation. 
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RSX-llS  SYSTEM  GENERATION  PROCESS 


This  chapter  briefly  explains  generating  an  RSX-llS  system  on  the 
various  host  systems,  creating  the  system  image,  and  task  building  the 
Executive  and  the  system  and  user-written  tasks.  General  information 
that  you  will  need  to  generate  your  system  is  given  at  the  end  of  the 
chapter . 

When  you  answer  questions  during  the  system  generation,  you  can  press 
I5D  to  answer  No  to  a  YES/NO  question  or  to  specify  the  default 
value  when  the  question  asks  for  a  numeric  answer. 

System  generation  dialogues  for  the  various  host  systems  are  presented 
in  Chapters  5,  6,  and  7. 


4.1   SYSTEM  GENERATION  ON  AN  RSX-llM  HOST 

A  complete  RSX-llS  system  generation  is  performed  in  two  phases  on  an 
RSX-llM  host  system.  In  the  first  phase,  the  procedures  are  primarily 
the  same  as  those  followed  for  generating  an  RSX-llM  system.  (Consult 
the  RSX-llM  System  Generation  and  Installation  Guide  for  a  detailed 
description  of  this  phase  of  the  SYSGEN.)  This  phase  is  controlled  by 
the  command  file  11SGEN.CMD,  which  is  found  in  UFD  [2,20]  of  the 
RSX-llS  distribution  medium  labeled  llSKITl. 

The  command  file  that  controls  the  second  phase  of  the  RSX-llS  system 
generation  is  11SGEN2.CMD,  which  is  also  in  UFD  [2,20].  The  RSX-llS 
system  generation  procedures,  IISGEN  and  11SGEN2,  expect  to  find 
11SGEN.CMD  and  11SGEN2.CMD  in  UFD  [200,200]  on  your  baseline  disk; 
therefore,  you  must  copy  them  as  described  in  Section  4.1.1. 

The  operations  performed  during  the  processing  of  11SGEN.CMD  are: 

•  Prompting  for  the  Executive  options 

•  Assembling  the  Executive 

•  Assembling  the  drivers 

The  operations  performed  during  the  processing  of  11SGEN2.CMD  are: 

•  Building  the  target  Executive  and  the  drivers 

•  Assembling/building  the  RSX-llS  system  tasks 

•  Final  configuring  of  the  Executive  (creating  the  system  image) 

The  Phase  2  operations  are  discussed  in  Sections  4.4,  4.5,  and  4.6, 
respectively. 
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4.1.1   Copying  Procedures 

Before  starting  an  RSX-llS  system  generation  on  an  RSX-llM  host,  copy 
[2, 201 11SGEN.CMD  and  [2, 20) 1 1SGEN2.CMD  from  the  1 xSKIT  d Istr ibut ion 
media  to  [200,200]  on  the  disk  on  which  the  system  generation  is  f  be 
performed.  To  copy  the  files,  use  PIP  if  your  distributirn  kit  ia  on 
disk(s)  or  PLX  if  your  kit  is  on  magnetic  tape(s).  If  you  have  a 
2-volume  distribution  kit,  the  command  files  are  on  the  one  labeled 
llSKITl. 


4.1.2   Invoking  the  Systea  Generation  Programs 

Use  the  following  command  to  invoke   the   Phase   1   system  generation 
programs: 

>gllSGEM.CMD 

Use  the  following  command  to  invoke   the   Phase   2  system  generation 
programs : 

>gllSGEN2.CMD 


4.1.3   Notes 

1.  If  you  are  running  on  an  RLOl  or  dual  RK05  kit,  be  sure  to 
make  a  copy  of  the  RSX-11»1  kit  because  11SGEN2  deletes 
selected  f'les  to  make  room  for  later  stages  of  the  RSX-llS 
system  genctation. 

2.  Copy  the  11SGEN.CMD  and  11SGEN2.CMD  files  from  [2,20]  on  the 
distribution  media  to  [200,200]  on  the  baseline  disk. 

If  you  ore  doing  the  system  generation  from  the  baseline 
disk,  you  might  have  to  load  the  device  driver  for  the  IIS 
distribution  kit  medium.  After  the  files  have  been  copied, 
you  must  unload  the  driver. 

Whether  you  are  doing  the  system  generation  on  line  or  from 
the  baseline  disk,  you  must  dismount  (and  deallocate  if  you 
are  on  a  multiuser  system)  the  RSX-llS  distribution  kit 
device  before  beginning  the  SYSGEN. 

3.  If  you  are  doing  the  system  generation  on  line,  assign  the 
baseline  disk  to  be  your  system  disk  (ASN  ddnnt^SY:). 

4.  Always  perform  the  RSX-llS  system  generation  with  the  command 
files  in  UFD  [200,200]  only. 

5.  If  you  are  performing  an  RLOl  or  RK05  RSX-llS  system 
generation,  listing  files  for  privileged  tasks  are  deleted 
automatically  to  provide  room  for  the  SYSGEN. 

For  further  information  on  generating  the  RSX-llS  system,  see   Section 
4.4  and  following  sections. 
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4.2   SYSTEM  GENERATION  ON  AN  RSX-IIM-PLUS  HOST 

An  RSX-llS  system  generation  on  an  RSX-llM-PLUS  host  requires  the 
RK05,  RK06,  RK07,  RLOl,  RL02,  or  magnetic  tape  RSX-llS  distribution 
kit.  In  addition,  the  disk  on  which  the  system  generation  is 
performed  must  be  an  RK06/07,  RM02/03,  RM05,  RP02/03,  or  RP04/05/06. 
During  the  system  generation  procesr,  a  number  of  files  will  be 
transferred  to  this  disk.  The  disk  must  have  approximately  8000  free 
blocks  to  accommodate  these  files  anvj  the  generation  of  the  target 
system. 

You  can  perform  an  RSX-llS  system  generation  on  the  host  system  disk 
or  on  another  disk.  If  you  use  tho  host  system  disk,  you  can  select 
group  numbers  during  the  system  generation  procedure  for  the  RSX-llS 
system  and  Executive  files  so  that  they  will  not  conflict  with  the 
files  already  on  the  disk.  The  valid  group  numbers  you  can  select  are 
3  through  10.   The  default  group  is  3. 

You  can  also  select  the  group  numbers  if  you  use  a  disk  other  than  the 
host  system  disk.  In  this  case,  the  valid  group  numbers  are  1  through 
10  for  the  system  files  (1  is  the  default)  and  1  through  11  for 
Executive  files  (11  is  the  default). 

If  you  select  alternate  group  numbers  for  the  system  and  Executive 
files,  note  that  you  must  explicitly  specify  the  UFD  in  the  command 
line  whenever  you  want  to  use  such  files  as  the  system  object  library 
(SYSLIB.OLB)  or  the  s:>stem  macro  library  (RSXMAC.  S.'^L)  .  Normally,  the 
Task  Builder  and  the  MACRO-11  assembler  expect  to  find  these  libraries 
in  UFD  [1,1].   See  Section  4.7  for  more  information. 

If  you  generate  more  than  one  RSX-llS  sy:jtem  onto  the  same  target  disk 
by  specifying  additional  system  and  Executive  group  numbers,  the  disk 
must  have  enough  free  blocks  on  it  to  contain  each  additional  RSX-11'^ 
SYSGEN.  Each  additional  RSX-llS  system  generation  is  ssgregated  from 
the  previous  SYSGEN (s). 

A  complete  RSX-llS  system  generation  is  performed  in  two  phases  on  an 
RSX-llM-PLUS  host.  The  procedure  is  controlled  by  the  indirect 
command  files  11SGEN.CMD  and  11SGEN2.CMD,  which  reside  on  the 
distribution  media.  In  the  first  phase,  the  procedures  are  controlled 
by  the  command  file  11SGEN.CMD  and  are  primarily  the  same  as  those 
followed  for  generating  an  RSX-llM  system.  (Consult  the  RSX-llM 
System  Generation  and  Installation  Guide  for  a  detailed  description  of 
Phase  T  oF  the  SYSGEN. )  The  second  phase  of  the  RSX-llS  system 
generation  is  controlled  by  the  command  file  11SGEN2.CMD, 

Because  the  RSX-llS  system  generation  programs,  USGEN  and  11SGEN2, 
expect  to  find  11SGEN.CMD  and  11SGEN2.CMD  in  UFD  [2,200)  on  yt'ir 
target  disk,  you  must  copy  them  as  described  in  Sections  4.2.1  and 
4.2.3. 

The  operations  performed  during  the  processing  of  11SGEN.CMD  are: 

•  Prompting  for  the  Executive  options 

•  Assembling  the  Executive 

•  Assembling  the  drivers 
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The  operations  performed  during  the  processing  of  11SGEN2.CMD  are: 

•  Building  the  target  Executive  and  the  drivers 

•  Assembling/building  the  RSX-llS  system  tasks 

•  Final  configuring  of  the  Executive  (creating  the  system  iina<]e) 

The  Phase  2  operations  are  discussed  in  Sections  4,4,  4.5,  and  4. ft, 
respectively. 

4.2.1  Copying  Procedures 

Before  starting  an  RSX-lir:  system  generation  on  an  RSX-llM-PLUS  host, 
copy  r2,?ni 11SGEN.CMD  and  [ 2, 20] 1 1SGEN2.CMD  from  the  IISKIT 
distribution  media  to  f2,200]  on  the  disk  upon  which  the  system 
generation  is  to  be  performed.  If  you  have  a  ?-volume  distribution 
kit,  the  command  files  are  on  the  one  labeled  llSKITl. 

All  other  files  needed  for  the  systom  generation  are  copied  to  your 
target  disk  by  the  procedure  11SC0PY.CMD,  which  is  invoked  by  IISGEN. 
The  file-copying  process  takes  approximately  ftO  to  90  minutes. 

4.2.2  Invoking  the  System  Generation  Programs 

Use  the  following  command  to  invoke  the  Phase  1  system  generation 
programs : 

>§1 1SGEN.CMD 

Use  the  following  command  to  invoke  the  Phase  2  system  generation 
programs : 

>91 1SGEN2.CMD 


4.2.3   Notes 


1.  Copy  11SGEN.CMD   and   11SGEN2.CMD   from   UFD   [2,20]   or   the 
distribution  media  to  UFD  r2,200]  on  the  target  disk. 

2.  Assign  SY:   to  the  target  device  (ASN  ddnn:=SY:). 

3.  Always  perform  the  RSX-llS  system  generation  with  the  command 
files  in  UFD  (2,200]  only. 

4.  Install  the  following  tasks: 


PIP 

LBR 

FLX 

LOA 

UFD 

MOU 

INI 

UNL 

EDI 

DM0 

MAC 

TKB 

Listing  files  of   privileged   tasks   are  not   automatically 
deleted . 
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6.  The  VMR  that  is  used  for  generating  the  RSX-llS  system  ojx  an 
RSX-UM-PLUS  host  is  the  RSX-llM  VMR.  It  is  installed  and 
run   under    the   name   VMM,    but    it   still    prompts   with   VMR>. 

7.  The  Task  Builder  that  is  used  to  build  the  RSX-llS  tasks  on 
an  RSX-llM-PLUS  host  is  the  RSX-llM  TKB.  It  is  installed  and 
run   under    the   name   TKM,    and    it   prompts   with  TKM>. 

8.  If  you  are  planning  to  save  the  target  system  (using  VMR 
SAVE)  to  some  device,  MOUnt  the  device  with  the  Foreign 
keyword    (/FOR)    before   beginning    the   system  generation. 


For    further    information  on  generating    the   RSX-llS   system,    see 
4.4   and    following    sections. 


Section 


4.3   SYSTEM  GENERATION  ON  A  VAX/VIIS  HOST 

The  procedure  for  generating  an   RSX-llS   system   on  a      VAX/VMS  host 

system  is  described  in  Chapter  7  of  this  manual.   The  chapter  explains 

how  to  begin  the  system  generation   and   provides   an  example  of   an 
actual  SYSGEN. 


4.4   BUILDING  THE  EXECUTIVE 

The  first  step  in  building  the  Executive  is  to  obtain  th"  system 
generation  output  and  the  Executive  object  library.  (The  command 
files  controlling  the  RSX-llS  system  generation  will  enst  e  that  all 
required  files  are  present.)  This  output  consists  of  at  least  three 
files: 

RSXllS.OLB  —  Executive  object  library 

RSXBLD.CMD  —  Executive  task-build  command  file 

RSXMC.MAC   —  Executive  assembly  prefix  file 

Additional  files  are  present  if  you  included  support   for 
UDCll,  IPll,  or  ICS/ICRll  subsystems  in  the  Executive. 


the   DSSll, 


If,  during  Phase  1,  you  selected  one  or  more  user-written  resident 
drivers,  you  can,  during  Phase  2,  insert  the  drlver(s)  and  data  base 
object  module(s)  into  RSXllS.OLB.  You  must  edit  the  Executive 
task-build  command  file  to  include  the  resident  drivers. 

After  the  Task  Builder  builds  the  target  Executive,  the  task  image 
file  RSXllS.TSK  and  the  symbol  table  files  are  in  the  UFD  designated 
for  system  tasks:  [1,60]  for  unmapped  systems  and  [1,64]  for  mapped 
systems. 

To  prevent  accidental  loss  of  your  system,  you  should  maintain 
RSXllS.TSK  as  a  backup  after  11SGEN2  creates  your  system  image  file 
(RSXllS.SYS) . 


4.5   BUILDING  THE  RSX-llS  TASKS 

You  can  write  RSX-llS  tasks  in  MACRO-U  or  FORTRAN  (for  the  FORTRAN  IV 
or  FORTRAN  IV-PLUS  compiler).  To  ensure  that  FORTRAN  tasks  are  linked 
properly  to  the  Object  Time  System   (OTS) ,   you  must   place   the   OTS 
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modules  In  a  library  and  then  specify  that  library  in  the  task-build 
command  line.  The  steps  to  include  GTS  are  documented  in  the 
appropriate  FORTRAN  installation  guide. 

Section  4.5.1  describes  building  system  tasks  and  Section  4.5.2 
describes  building  other  kinds  of  tasks. 


4.5.1   System  Tasks 

Seven  system  tasks  may  be  included  in  the  RSX-llS  system.  They  are 
TKTN,  Basic  MCR,  OTL,  SIP,  and  the  system  activity  display  programs 
RSDV05,  RSDV52,  and  RSDVIH. 

During  the  processing  of  IISGEN,  you  are  asked  whether  the  assembly 
listings  and/or  the  task-build  maps  for  TKTN,  Basic  MCK,  OTL,  SIP,  and 
the  system  activity  display  programs  should  be  printed.  The  desired 
listing  output  is  sent  to  the  line  printer  if  one  is  available.  If 
not,  the  listing  is  printed  on  the  console  terminal. 

The  sizes  of  Basic  MCR,  OTL,  and  SIP  depend  on  the  inc'usion  of 
several  optional  features.  The  respective  build  files  for  each  of 
these  tasks  allows  for  the  maximum  size  of  the  task.  However,  even  if 
you  do  not  include  all  of  the  options  for  Basic  MCR,  OTL,  or  SIP,  it 
is  not  necessary  to  edit  the  build  file  to  reduce  the  size  of  the 
partition  for  that  task.  When  configuring  the  system  with  VMR,  use 
the  map  listings  to  determine  the  size  of  the  partition  for  each  of 
the  tasks.  A  task  can  be  loaded  into  a  partition  smaller  than  the 
size  specified  in  the  build  file  as  long  as  the  partition  is  large 
enough  to  include  the  task  address  limits. 


4.5.1.1  TKTN  -  TKTN  is  the  privileged  task  used  by  the  Executive  to 
print  task  termination  and  device  status  messages.  If  you  select  TKTN 
during  Phase  1,  it  is  assembled  and  built  during  the  11SGEN2 
procedure. 

The  command  file  TKN11SBLD.CMD  specifies  that  you  use  partition 
SYSPAR,  with  a  length  of  3700(8)  bytes  and  a  base  address  of  20000  for 
unmapped  systems.  Normally,  the  default  base  address  of  TKTN  for  an 
unmapped  system  is  not  correct  and  must  be  changed  to  the  proper 
address.   On  a  mapped  system,  SYSPAR  is  3700(8)  bytes  long. 


4.5.1.2  Basic  MCR  -  Basic  MCR  supplies  the  RSX-llS  user  with  a  subset 
of  the  MCR  commands  available  in  RSX-llM.  The  commands  are  described 
in  Section  2.1  of  this  manual. 

The  size  of  Basic  MCR  varies  from  approximately  6300(8)  to  12100(8) 
bytes  with  a  base  address  of  20000  for  unmapped  systems,  and  6400(8) 
to  14000(8)  bytes  for  mapped  systems.  The  differ'^nce  in  size  between 
the  smaller  and  larger  versions  is  due  to  the  inclusion  of  optional 
features.  These  are  the  ATL/TAL  commands,  the  OFJIN  command,  and  full 
error  message  text. 
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As  distributed,  the  Basic  MCR  assembly  prefix  file,  BMPRE.MAC, 
produces  a  Basic  MCR  that  does  not  include  any  of  the  optional 
features.  To  include  an  option,  edit  the  assembly  prefix  file.  To 
edit  the  file,  locate  the  control  symbol  corresponding  to  the  desired 
option  and  remove  the  semicolon  (;)  from  the  beginning  of  the  line 
(refer  to  the  sample  dialogues  in  Chapters  5,  6,  and  7).  The  control 
symbols,  along  with  their  corresponding  options,  are  as  follows: 

R$$ATL  —  ATL/TAL  commands 

R$$ERM  —  full  error  message  text 

R$$OPE  —  OPEN  command 

It  is  recommended  that  you  choose  the  full  form  of  the  error  messages 
so  that  you  will  not  have  to  look  them  up  every  time. 

The  Basic  MCR  task-build  command  file,  called  BASMCRBLD.CMD,  specifies 
that  partition  MCRPAR  be  used,  with  a  maximum  length  of  12100  bytes 
for  unmapped  systems  (14000  for  mapped  systems)  and  a  base  address  of 
20000  for  unmapped  systems.  The  specification  at  task-build  time  of  a 
partition  length  that  is  larger  than  necessary  has  no  effect  on  the 
task  image.  However,  for  an  unmapped  system,  you  must  determine  the 
partition  base  address  by  carefully  examining  the  memory  requirements 
of  other  system  components. 


4.5.1.3  OTL  -  The  On-Line  Task  Loader  (OTL)  allows  you  to  install  and 
fix  a  task  in  a  running  RSX-llS  system.  You  must  build  the  task  on 
the  host  system  and  copy  it  to  a  medium  supported  by  OTL  and  the 
RSX-llS  system  (that  is,  the  device  driver  for  that  medium  must  be 
loaded  in  the  RSX-llS  system  with  VMR) .  If  OTL  is  to  be  included,  you 
must  assemble  and  build  it  during  the  RSX-llS  SYSGEN  procedure. 

The  size  of  OTL  varies  from  approximately  6200(8)  to  10600(8)  bytes 
for  unmapped  systems  and  from  10000(8)  to  15000(8)  bytes  for  mapped 
systems.  The  difference  in  size  between  the  smaller  and  larger 
versions  is  due  to  the  inclusion  of  optional  error  message  text  and 
device  support. 

As  distributed,  the  prefix  file  does  not  include  support  for  full 
error  message  text.  To  include  it,  edit  the  assembly  prefix  file 
OTLPRE.MAC.  Locate  the  line  in  which  the  control  symbol  R$$ERM  is 
assigned  the  value  0  and  remove  the  semicolon  (;)  from  the  beginning 
of  the  line.  It  is  recommended  that  you  choose  the  full  form  of  the 
messages  so  that  you  will  not  have  to  look  them  up  every  time. 

OTL  supports  the  following  load  devices: 


Load  Device 

PCll/PRll  paper  tape  reader 
RXll  flexible  disk 
RX211  flexible  disk 
TAll  cassette  tape 
TCll  DECtape 

TM/TMA/TMBll  magnetic  tape 
TSll  magnetic  tape 
TJ/TWU16-45  magnetic  tape 
DECtape  II 


OTL 

Assembly  Control 

Symbol 

PRll 

RXll 

RX21 

TAll 

TCll 

TMll 

TSll 

TJ16 

TU58 
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OTL  automatically  supports  any  of  the  above  devices  that  were  included 
in  the  RSX-llS  system  during  system  generation.  OTL  requires  that  the 
driver  for  any  device  you  want  to  use  be  in  the  system  (either 
resident  or  loadable) . 

To  make  OTL  smaller,  you  can  limit  the  types  of  devices  supported  by 
OTL  by  editing  the  assembly  prefix  file  OTLPRE.MAC.  Locate  the  line 
that  contains  "INCLUDE",  followed  by  the  symbol  for  the  device  type 
you  wish  to  exclude.  (Refer  to  the  OTL  assembly  control  symbols  shown 
above.)  Insert  a  semicolon  (;)  at  the  beginning  of  the  line.  The  line 
will  be  treated  as  a  comment  and  the  code  required  to  support  the 
device  type  will  not  be  included  in  OTL  when  it  is  assembled. 

The  OTL  task-build  command  file  OTLBLD.CMD  specifies  that  partition 
OTLPAR  be  used,  with  a  maximum  length  of  10600(8)  for  unmapped  systems 
(15000  for  mapped  systems]  and  with  a  base  address  of  20000.  You 
should  edit  this  file  according  to  the  guidelines  specified  for  Basic 
MCR. 


4.5.1.4  SIP  -  The  System  Image  Preservation  task  (SIP)  allows  you  to 
save  (up  to  124K  words)  a  copy  of  a  running  RSX-llS  system  on  a  medium 
that  can  be  bootstrapped.  If  SIP  is  to  be  included,  you  have  the 
option  of  tailoring  SIP  in  exactly  the  same  manner  as  that  discussed 
in  the  previous  section  for  OTL. 

The  size  of  SIP  varies  from  approximately  3500(8)  to  6700(8)  bytes  for 
unmapped  systems  and  from  3700(8)  to  7400(8)  bytes  for  mapped  sytems. 
Again,  the  size  difference  between  the  smaller  and  larger  versions  is 
due  to  the  inclusion  of  optional  error  message  text  and  device 
support.  You  can  adapt  SIP  to  meet  specific  system  needs  by  editing 
its  assembly  prefix  file  SIPPRE.MAC,  using  the  same  guidelines 
discussed  for  OTL. 

As  distributed,  SIPPRE.MAC  does  not  include  full  error  message  text. 
To  include  it,  edit  the  assembly  prefix  file  by  locating  the  line  in 
which  the  control  symbol  R$$ERM  is  assigned  the  value  0  and  removing 
the  semicolon  ( ; )  from  the  beginning  of  the  line.  It  is  recommended 
that  you  choose  the  full  form  of  the  messages  so  that  you  will  not 
have  to  look  them  up  every  time. 

There  are  a  few  minor  differences  in  device  support  between  SIP  and 
OTL.  One  difference  concerns  paper  tape.  OTL  reads  a  task  image  into 
memory  and  therefore  uses  the  paper  tape  reader.  On  the  other  hand, 
SIP  writes  a  system  image  and  must  use  the  paper  tape  punch.  The 
control  symbol  employed  by  SIP  for  the  PCll  paper  tape  punch  is  PPll. 
SIP  also  does  not  support  the  TU58  DECtape  II  and  TSll  magnetic  tapes. 

The  SIP  task-build  command  file  SIPBLD.CMD  specifies  that  the 
partition  SIPPAR  be  used,  with  a  maximum  length  of  6700(8)  for 
unmapped  systems  (7400  for  mapped  systems)  and  with  a  base  address  of 
20000.  You  should  edit  this  file  according  to  the  guidelines  given 
for  Basic  MCR. 


4.5.1.5  SETTIM  -  To  generate  SETTIM,  which  sets  the  system  time,  you 
need  the  SET  SYSTEM  TIME  ($STIM)  directive.  This  directive  is  one  of 
the  Executive  options  you  can  select  in  Phase  1  of  the  RSX-llS  system 
generation  procedure. 
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4.5.1.6  RSDV05,  RSDV52,  and  RSDVIH  (R8D)  -  RSDV05,  RSDV52,  and  RSDVIH 
are  the  system  activity  display  programs.  They  are  privileged  tasks 
that  run  on  VT05,  VT52,  and  VTIOO  video  terminals,  respectively.  The 
RSD  tasks  require  approximately  6K  words  of  memory  to  run  on  RSX-llS. 
(These  display  programs  are  similar  to  the  RMDEMO  display  program  on 
RSX-llM  and  RSX-llM-PLUS;  see  the  RSX-llM/M-PLUS  System  Management 
Guide  for  more  information.) 

If  you  include  any  of  the  RSD  tasks  in  your  system,  you  should  select 
the  following  two  options  during  the  system  generation  process: 

e   Executive  AST  support 

e  Unsolicited  input  character  AST  (terminal  driver  option) 

(This  option  is  available  in  all  terminal  drivers  except  the 
baseline  terminal  driver.) 

Selecting  these  options  will  enable  you  to: 

e   Exit  cleanly  from  an  RSD  display  by  using  CTRL/C  or  CTRL/Z, 
Otherwise,  you  must  type  CTRL/C  and  then  abort  RSD. 

e  Generate  an  updated  display  (replay)  at  any  time  by  pressing 
the  keyboard  space  bar  or  any  other  keyboard  character. 


4. 5. 2  Other  Tasks 

This  section  gives  information  on  generating  tasks  that  are  not  system 
tasks,  but  ones  that  you  may  need. 


4.5.2.1   K-SERIKS  Lab  Support  Routines  -  The  K-SERIES   lab   support 

routines  are  built  by  SGNKLAB,  which  is  run  separately,  subsequent  to 

Phase  2.   During  SYSGEN  Phase   1,   you  will  be  asked   if   you  want 
K-SERIES  support.   If  the  answer  is  Yes: 

e  You  will  be  prompted  for  the  required  vector  information.  If 
the  K-SERIES  devices,  or  any  other  devices,  require  an 
interrupt  vector  address  greater  than  400,  you  must  specify 
the  highest  address  needed. 

e  The  CINTS  directive  will  be  included  in  your  system. 

e  AST  support  will  be  included  in  the  system. 

To  build  these  routines,  use  one  of  the  following  command  lines  after 
completing  Phase  2: 

>§f iOO,200)SGNKLAB  (on  RSX-llM  host) 

>?f2,2001SGNKLAB  (on  RSX-llM-PLUS  or  VAX/VMS  host) 

For  more   information  on   the   K-SERIES   routines,   refer    to   the 
RSX-llM/M-PLUS  I/O  Drivers  Reference  Manual. 
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4.5.2.2  User-Written  Tasks  -  To  properly  assemble  and  link  any 
user-written  tasks  that  are  to  be  included  In  the  target  system, 
special  library  conventions  must  be  observed.  You  must  use  EXEMC.MLB 
as  the  macro  library  and  IISLIB.OLB  as  the  system  library.  (System 
libraries  are  discussed  in  Section  4.7.1.) 


4.6   FINAL  CONFIGURATION  OF  THE  EXECUTIVE 

Once  the  RSX-llS  Executive  and  all  of  the  privileged  tasks  are  built, 
there  remain  the  steps  of  creating  memory  partitions  in  the  system, 
loading  required  device  drivers,  installing  the  needed  tasks,  and 
fixing  them  in  memory.  These  steps  must  be  done  before  you  can 
bootstrap  and  run  the  system.  Run  VMR  on  the  system's  task  image  file 
to  do  these  procedures. 

The  minimum  required  steps  include  creating  all  of  the  partitions, 
loading  the  required  device  drivers  and,  if  tasks  are  to  be  loaded  on 
line,  installing  and  fixing  into  memory  Basic  MCR  and  OTL.  Once  these 
are  in  memory,  tasks  and  commons  can  be  loaded  into  a  runn.ng  RSX-llS 
system  by  using  OTL. 

If  the  RSX-llS  system  is  a  DECnet  node  and  it  supports  down-line  task 
loading,  OTL  is  not  needed  for  on-line  loading  of  nonresident  tasks 
(since  the  tasks  can  be  down-line  loaded  by  DECnet). 

To  set  up  partitions  and  install  required  tasks  on  the  target  system, 
use  the  following  procedure: 

1.  Install  and  run  VMR. 

2.  Extend  pooi  space  to  the  base  of  the  first  partition. 

3.  Set  up  partitions  by  consulting  the  maps  for   the   privileged 
tasks. 

4.  Load  loadable  device  drivers. 

5.  Install  privileged  tasks  (Basic  MCR,  OTL,  SIP,  TKTN) . 

6.  Fix  tasks  into  (virtual)  m''mory. 

7.  Optionally  set  the  time  and  save  a  copy  of  the   system  on   a 
bootable  medium. 

8.  Exit  from  VMR. 

Example  4-1  shows  the  application  of  this  procedure. 
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Example  4-1   Final  Configuration  of  the  Executive  for  a  Mapped  System 

with  Executive  Commons,  System-Controlled  Partitions, 

and  Loadable  Device  Drivers 

MCR>SET  /UIC-ri,fi41 

MCR>INS  $11MVMR/TASK-. . .VMM 

MCR>VMM 

ENTER  FILENAME:  RSXllS.SYS 

VMR>SET  /POOL-* 

VMR>SET  /MAIN=iTTPAR:*;164:TASK 

VMR>LOA  TT: 

VMR>SET  /MAIN-DRVPAR:*:*:SYS 

VHR>LOA  MM: 

VMR>LOA  DM; 

VMR>LOA  DKi 

VMR>SET  /TOP=DRVPAR:-* 

VMR  —  *DIAG*  Installed  tasks  may  no  longer  fit  in  partition 


VMR>SET  /MAIN=SYSPAR:* 
VMR>SET  /MAIN=MCRPAR:* 
VMR>SET  /MAIN=OTLPAR:* 
VMR>SET  /MAIN^SIPPAR:* 
VMR>SET  /MAIN=EXC0M1:* 
VMR>INS  EXCOMl 


; 37: TASK 
:140:TASK 
;150:TASK 
[74: TASK 
I  200: COM 


VMR  —  *DIAG*  Partition  reduced  to  executive  common  size 

VMR>SET  /MAIN=EXCOM2:*:200:COM 
VMR>INS  EXC0M2 

VMR  —  *DIAG*  Partition  reduced  to  executive  common  size 

VMR>SET  /MAIN=GEN:*:*:TASK 

VMR>INS  TKN 

VMR>FIX  TKTN 

VMR>INS  BASMCR 

VMR>FIX  MCR... 

VMR>INS  OTL 

VMR>FIX  OTL 

VMR>INS  SIP 

VMR>FIX  SIP 

VMR>"Z 


If   you   answer 
question,   "Do 
Executive  at  th 
would  follow  th 
the   Phase    2 
creates    the 
automatically 
When    VMR   pr 
procedur<i  outli 


NOTE 

ed  No  to  the  Phase  2 
you  want  to  configure  the 
is  time  using  VMR,"  you 
is  procedure.  Otherwise, 
program  automatically 
system  image  file  and 
installs  and  runs  VMR. 
ompts  you,  follow  the 
ned  above. 
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4.7   OPERATING  CONSIDERATIONS 


The  remainder  of  this  chapter  gives  information 
helpful  in  generating  your  RSX-llS  system. 


that  you  may  find 


4.7.1  Libraries 

You  should  be  aware  of  the  three  types  of  libraries  on  the  RSX-llS 
system;  system  object,  system  macro,  and  resident.  The  following 
sections  give  brief  descriptions  of  each  of  these  libraries. 


4.7.1.1  Systen  Object  Library  -  Although  the  host  system  has  a 
complete  system  object  library  (SYSLIB.OLB)  of  its  own,  you  should 
create  an  additional  object  library  for  tasks  to  use  several 
h  rdware/software  features  on  the  target  RSX-llS  system.  To  support 
tne  features,  your  RSX-liS  system  object  library  must  contain  the 
following  modules; 


(required  with  FORTRAN  GTS) 


Subset  PCS 

FORTRAN  OTS 
LPS/ARll 
ICS/ICRll 
UDCll 
DRS/DSSll 
IPll 
Purdue  ISA 


LPAll 

During  the  RSX-llS  system  generation,  this  library,  called  IISLIB.OLB, 
is  created  under  the  system  directory  of  the  target  system  device 
(SY:).  (On  RSX-llM,  the  system  directory  is  [1,1].  On  RSX-llM-PLUS 
and  VAX/VMS,  the  directory  is  [g,l],  where  g  is  the  grcup  number 
specified    for   system   files  during    the   SYSGEN  procedure.) 

When  building  tasks  for  the  target  RSX-llS  system  that  require  any  of 
the  features  listed  above,  you  should  include  the  file  specification 
for  your  system  object  library  in  the  task-build  command  input.  This 
specification  prevents  the  IISGEN  command  file  from  referencing  the 
host   system's  system   library. 

Also  note  that  if  you  have  selected  a  UFD  other  than  [1,1]  for  your 
system  object  library  (RSX-llM-PLUS  and  VAX/VMS  hosts  only),  you  must 
explicitly  specify  the  directory  with  the  /DL  switch  when  building  a 
task.  Otherwise,  the  Task  Builder  will  expect  to  find  SYSLIB.OLB  in 
[1,11. 


4.7.1.2  SysteB  Macro  Library  -  You  must  use  the  standard  system  macro 
library  RSXMAC.SML  for  program  development  on  an  RSX-llM, 
RSX-llM-PLUS,  or  VAX/VMS  host.  As  with  SYSLIB.OLB,  if  RSXMAC.SML  is 
not  in  UFD  [1,1],  you  must  explicitly  specify  the  directory  in  the 
MACRO-11   command    line   when   assembling    a  module. 
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4.7.1.3  Subset  PCS  R«sld*nt  Library  -  You  create  the  standard  PCS 
resident  library  by  assembling  the  file  PCSRCS.MAC  and  task-building 
it  according  to  the  directions  it  contains.  The  procedure  to  follow 
is  described  in  the  source  file  itself.  However,  two  additional  steps 
are  required  to  build  a  resident  library  containing  the  subset  PCS. 

You  must  edit  the  file  PCSRES.MAC  to  delete  the  lines  containing  the 
definitions  for  the  following  global  symbols:  .OPPID,  .PUTSQ,  and 
.GETSQ.  When  building  the  library,  add  the  file  specification  for 
your  system  object  library  to  the  task-build  command  input  as  follows: 

[g,l]llSLIB/LB 

Por  more  information  on  building,  defining,  and  loading  resident 
libraries  Into  a  system,  see  the  RSX-llM  System  Generation  and 
Installation  Guide  and  the  RSX-llM/M-PLUS  Ta"sT(  Builder  Manual. 


4.7.2  Device  CoMEOons 

Several  DIGITAL-suppl ied  support  routines  require  direct  access  to  the 
I/O  page  to  service  some  process-I/0  options.  On  mapped  systems,  the 
construction  of  a  device  common  is  required  to  obtain  direct  access; 
construction  of  a  device  common  is  optional  on  an  unmapped  system. 
Direct  access  is  required  to  support  the  following  options: 

UDCll  ANALOG  outputs 

Single-shot  digital  outputs 
Digital  inputs 
Counter  inputs 

ICS/ICRll      Digital  inputs 
Counter  inputs 

DSSll  All 

The  IISGEN  procedure  automatically  constructs  device  commons  when  you 
request  direct  access  for  the  above  devices  or  the  device  common 
itself  (answer  Yes  to  the  questions) . 

Device  commons  are  loaded  into  the  nystem  by  first  creating  a 
partition  having  the  DEV  attribute  that  maps  the  desired  portion  of 
the  I/O  page.  Then  the  INSTALL  command  is  used  to  mark  the  device 
common  resident.   You  can  perform  these  steps  using  VMR  commands. 

Por  more  information  on  processing  I/O  device  commons,  see  the 
RSX-llM/M-PLUS  I/O  Drivers  Reference  Manual. 


4.7.3  Other  Methods  for  Task  Loading 

By  virtue  of  its  memory-resident  design,   RSX-llS  relies  on   a 

host/target  system  relationship  for  program  development.   Tasks  for 

RSX-llS  systems  must  be  developed   on   the   host   system  and  may  be 

transported  to   the  target  system.   As  previously  discussed,  the 

On-Line  Task  Loader  (OTL)  is  provided  to  load   tasks   into   a   running 
RSX-llS  system. 
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There  are,   however,   two   alternative  methods   to   accomplish  task 

loading.    The   first   relies  on  VMR  to  install  and  fix  the  task  image 

into  the  RSX-llS  system  image.  When  this  image  is  bootstrapped  into 
memory,  the  task  is  available  to  be  run. 

The  second  method  requires  the  facilities  oi.  DECnet-11  V3.0,  the 
RSX-11  network  software.  A  special  network  task  loader  is  provided  to 
down-line  load  task  images  over  a  communications  line.  Furthermore, 
the  capability  of  RSX-llS  is  enhanced  by  DECnet  to  support  task 
checkpointing  to  the  host  by  means  of  the  network  loader.  Both  the 
host  and  target  system  must  be  configured  with  DECnet  to  use  these 
features.  Refer  to  the  DECnet  System  Manager' s  Guide  for  more 
information. 


4.7.4  Systea  Loading 

When  you  complete  the  RSX-llS  system  generation,  you  must  bootstrap 
the  system  image  file,  RSXllS.SYS,  into  memory  at  some  time  for  it  to 
become  operational.  On  RSX-llM  hosts,  RSXllS.SYS  resides  in  [1,60] 
for  unmapped  systems  and  [1,64]  for  mapped  systems.  On  RSX-llM-PLUS 
and  VAX/VMS  hosts,  the  file  resides  in  [g,64],  where  g  is  the  group 
number  specified  for  system  files  during  the  system  generation 
procedure. 

VMR  on  the  host  system  has  the  capability  of  saving  the  contents  of 
the  system  task  image  file  to  a  variety  of  device  media  in 
bootstrappable  format.  You  can  load  these  system  images  directly  on 
the  target  configuration  using  the  appropriate  bootstrap  mechanism. 

A  host  system  configured  with  DECnet  allows  the  down-line  loading  of 
an  RSX-llS  system  image.  This  feature  eliminates  the  necessity  of 
using  VMR  to  SAVE  an  RSX-llS  system  image  on  media  in  bootstrappable 
format. 

As  discussed  earlier,  you  can  save  a  running  RSX-llS  system  using  SIP, 
which  produces  a  bootstrappable  image  in  exactly  the  format  generated 
by  the  VMR  SAVE  command. 
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SYSGBN  DIALOGUE  PROM  AN  RSX-llM  HOST  SYSTEM 


5.1   INTRODUCTION 

This  chapter  contains  the  actual  terminal  dialogue  from  an  RSX-llS 
system  generation  on  an  RSX-llM  host. 

The  dialogue  and  procedures  in  Phase  1  are  the  same  for  RSX-llM  and 
RSX-llS;  for  detailed  explanations  of  the  Phase  1  system  generation 
questions,  see  the  RSX-llM  System  Generation  and  Installation  Guide. 

The  system  generated  in  the  example  in  this  chapter  supports  the 
following  hardware  configuration  for  a  PDP-11/40  processor: 

124K  memory 

60  cycle  line  clock 

1  RK05  cartridge  disk  controller  with  2  drives 

1  RK06  cartridge  disk  controller  with  2  drives 

1  TU56  DECtape  controller  with  2  drives 

1  TUlO  magtape  controller  with  2  drives 

1  LVll  line  printer  controller 

1  null  device  driver 

2  DLll  terminal  interfaces 

The  following  software  support  is  included: 

•  Large  (20K)  RSX-llS  Executive 

•  Support  for: 

Executive  common 

Memory  management 

Send/receive  directives 

Get  mapping  context  directive 

Address  checking 

I/O  rundown 

Loadable  device  drivers 

ASTs 

Powerfail  recovery 

Logical  device  assignment 

Crash  notification 

Group  global  event  flags 

Memory  parity 

•  TKTN 

•  XDT 
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•  System-controlled  partitions 

•  Basic   MCR  with  support   for   OPEN,    ATL/TAL,    and    full 
error-message  text 

•  OTL  with  support  for  full  error-message  text  and  for  all   OTL 
devices  generated  into  the  RSX-llS  system 

•  SIP  with  support  for  full  error-message  text  and  for  all   SIP 
devices  generated  into  the  RSX-llS  system 

•  RSDV52 

•  RSX-llS  Subset  File  Control  Services  (PCS) 

•  SETTIM 

The  system  generation  is  being  performed  on  an  RSX-llM  V4.0  RK06 
release  kit  baseline  disk.  The  RSX-llS  release  kit  consiats  of  two 
RK05S,  labeled  llSKITl  and  11SKIT2.  However,  you  will  only  need 
llSKITl. 

Questions  calling  for  a  YES/NO  answer  can  be  answered  by  pressing  the 
RETURN  key  for  a  "NO"  answer. 

You  can  also  answer  questions  asking  for  a  value  and  displaying  a 
default  value  by  pressing  the  RETURN  key  to  specify  the  default  value. 


Notes: 


1.  You  may  want  to  do  a  preliminary  system  generation  before  you 
do  your  actual  SYSGEN.  To  do  a  preliminary  SYSGEN,  you 
invoke  the  command  file  for  Phase  1  of  the  SYSGEN  (^IISGEN) 
and  answer  YES  to  the  question,  "Do  you  want  to  inhibit 
execution  of  MCR  commands?" 

Phase  1  continues,  but  the  answers  you  give  to  the  questions 
are  placed  in  a  saved  answer  file  instead  of  being  used 
immediately.  When  Phase  1  finishes,  you  reinvoke  11SGEN.CMD 
to  run  the  phase  again.  This  time,  you  do  not  inhibit  MCR 
command  line  execution  and  the  SYSGEN  procedure  uses  the 
answers  in  the  saved  answer  file. 

Doing  a  preliminary  SYSGEN  saves  time  and  prevents  mistakes. 
The  sample  dialogue  in  Section  5.7.  shows  a  preliminary  SYSGEN 
being  done  before  the  actual  SYSGEN  is  done. 

2.  During  Phase  1  of  the  system  generation  procedure,  11SGEN.CMD 
asks  for  the  device  configuration  of  your  system  and  also 
which  system  directives  you  would  like  in  the  Executive.  In 
both  cases,  you  can  print  out  a  table  of  the  available 
options  before  you  answer  the  question. 
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5.2      ACTUAL  DIALOGUE— RSX-1 IS   SYSTEM  GENERATION   ON  AN   RSX-llM   HOST 

RSX-llH    V4.0    BL32         124. K    MAPPED    (BASELINE) 
>RED  dn:'8y: 

>RED    DN!-LBt 
>HOU    DI1:RSXH32 
>*DH!Clf2]STARTUP 

■•PLEASE    ENTER    TIHE    AND    DATE    (HRJMN.  DD-MNM-YV)    t83J    13!40    19-0CT-81 
>TIM    13:40    19-0CT-81 

>«    ENTER    LINE    UIDTH    OF    THIS    TERMINAL    CD    Dil32.3i 
:>SET    /BUF'Ti:i32. 
>ACS    SY:/BLKS«1024. 
>»    <EOr> 

>LOA  dk:/par«oen 

>HOU  DKOniSKITl 

>INS  »PIP 

>PIP  DH0!C200>200]/NV>DK0!C2i20]llSGEN.CHDtllS0EN2.CND 

>0N0  DKO: 

DHO    —    TTO:  di*Riourit»d    fro*    DKO]  **»    Final    ditikount    initiattd    *** 

13:42:02      **«    DKO:    --    DlsMount   cokpltta 

>911S0EN 

>» 

>»  RSX-llS  y»rsion  4.0  BL32  Sustem  Generation  done  on  RSX-llM 

>» 

>!  CoFwriaht  <C)  1979»1981 

>i  Didital  Eauipmeni  Corporation*  Mavtnardf  Mass. 

>l  All  Ridhts  Reserved. 

>> 

>» 

>)  KK06  distribution  Kit 

>> 

>•   3.  Do  sou  Kant  to  inhibit  execution  of  MCR  commandsT  CY/N3:  Y 

>t   5.  Are  uou  deneratlnd  a  inspped  sustem?  CY/N!];  Y 

>*   7.  Use  an  input  saved  answer  file?  CY/NJ: 

>*  10.  Name  of  output  saved  answer  file  CD;  3YSSAVED.CMD3  CS3: 

>» 

>>  Phase  I  output  saved  answers  created  in  file  DM0:C200>2003SYSSAVED.CMDi2 

>» 

>» 

>» 

>i  Tardet  configuration 

>t 

>*   1.  Processor  Tape   CD:  11/34]   CSD;  11/40 

>♦   3.  Memory  size  (in  K-uord  blocks)  CD  R:1A.-124.  D:U.3:  124. 

>*   4.  Include  support  for  K-series  devices'  CY/N]: 

::  ♦   7,  Floating  instruction  set  (FIS)  present?  CY/N];  Y 

>*   8.  Extended  instruction  set  (EIS)  present?  CY/N3; 

>«   9.  If  usinfl  KUll-P  as  s^jste*  clock:  number  of  intrps./sec.  CD  R;0.-1000.  D:0.3: 

>«  10.  Line  fr?auenca:    A-  60  H:     ft-    50  Hz    CD:  AD  CSJ: 

>«  11.  KUll-Y  Uatchdoa  timer  support'  CY/N]: 

~*  12.  Memora  parita  support'  CY/N]:  Y 

.>f 

>i    The  response  to  the  following  auestion  specifies  the  hifle^t  interrupt 

>l  vector.   If  aou  respond  with  a    value  less  than  or  eoual  to  400f  SYSOEN 

>S  will  assisin  the  value  associated  with  the  highest  interrupt  vector 

>f  sppcified  durina  the  Peripheral  Section.   Therefore?  if  aour  sustem 

>f  will  include  devices  that  are  not  specified  durind  the  Peripheral 

>i    Section  and  which  have  vectors  above  400  (devices  such  as  K-series  and 

>>  certain  communication  devices)?  specifa  that  value  in  the  r,ey.t    auestion. 

>  f 

>♦  14.  Hislhest  intL»rrupt  vector  CO  h':0-774  D:C3; 

>i  for  device  configuration:  '«'  Prints  device  table?  "."  Terminates  inouira 

>S  ■?•  P.intb  current  configuration 

.:  r      tnter  devices  and  number  of  controllers  for  devices  which  require  drivers 

>*  15.  Devices  CSJ;  * 

.;■■■  t 
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;  Dvvic*    codf?'.    fur    A/li    «rid    iriduslr iiil/latiur«torw    dfFvic*»! 
>t 

>t  AD-    AOOl-D   A/n    Coiivartvr 

>|  AF-    AFC  11    A/ II    Converter 

>|  AR      AKll    Ldl'uidturw    Sub»-4«t»B 

>|  IC-    ICRll/ICSll     Iridu%ti>«l    Control    Sijt->v%t*a 

>l  IF--     IP)1/IP300    Industrtdl    Cur.trol    SubsM<>tea 

>f  IS'    DRSll/DSSll     Indufetridl    Control    Sutis^^ste* 

>f  LA-    LPAll    Laborjtorv    Substistea 

>l  US-    LPSll    L«bor4torv<    Subsw«te* 

>l  UD-    UDAU    Univ«r«al    Iiiditdl    CuntroUer 
>» 

>l  D*vic»  cod**  for  Intvrcrocv&bor  coaaunication  d*vic«»: 
>» 

>l  XH-  DAll-ii  Int»rproc»*6or  Link 

>|  XL-  DLll-E  Int«rproc»fcBor  Link 

>f  XH-  OHCll-E/ONRll  Interp roc««sor  Link 

>|  XF--  OPll  Synchronous  Interfac* 

>f  XQ-  001 1  Swnchronoufc  Interface 

>|  XU-  Dull  Synchronous  Interface 

>l  XU-  DUPll  Swnchronoub  Interface 
>l 

>l  Device  codes  for  unit  record  devices* 
>l 

>l  OR-  CRU/CHll-E  Card  Reader 

>f  GR-  VT11/VS60  Graphics  Subswsten 

>»  LP-  LA180/LP11/LS11/LV/11  Line  Printer 

>»  PP-  PCll  Paper  Tape  Punch 

>)  PR-  PCll/PRll  Paper  Tape  Punch  and  Reader 
>» 

>)  Device  codes  for  disks  devices: 
>» 

>l  DD-  RP04/RP0S/RP06  Disk  Drive 

>l  DD-  TUS8  Cartridrie  DECtape  II 

>|  OF-  RFll  Fixed  Head  Disk  Drive 

>f  DK-  RK03/RK0S  Pisk  Drive 

>|  DL-  RL01/RL02  D: sk  Drive 

>f  OH-  RK06/RK07  Disk  Drive 

>|  DP-  RP02/RP03  Disk  Drive 

>l  OR-  RN02/RN03/RH0S/RH80/RP07  Disk  Drive 

>|  OS-  RS03/RS04  Fixed  Head  Disk  Drive 

>f  DT-  TUS6  DECtape 

>l  OU-  UDASO  Unibus  Disk  Adapter 

>f  OX-  RXOl  Floppy  Disk  Drive 

>l  or-  RX02  FIoppi^  Disk 

>»  EH-  HLll  Non-Rotatind  Electronic  He»orvi 
>l 

>l  Device  codes  for  Haanetic  tapes  devices! 

>» 

>f  CT-  TU60  Cassette  Tape  Drive 

>t  HP-  TU78  Hafltape  Drive 

>l  HH-  TU1A/TU45/TU77/TE1A  Hadtape  Drive 

>f  HS-  TS04  Hadtape  Drive 

>l  HT-  TU10/TE10/TS03  Hadtape  Drive 

>i 

>i  Device  codes  for  terMinal  interface  devices! 

>f 

>l  YH-  OHll  Asynchronous  TerMinal  Interface 

>l  YJ-  DJll  Asynchronous  Terminal  Interface 

>l  YL-  DL11-A/-B/-C/-D/-E/-J/-U  Asynchronous  Terminal  Interfact 

>)  YZ-  DZll  Asynchronous  Ter»inal  Interface 


5-4 


m 


SYSGEM  DIALOGUE  FROM  AN  R8X-11N  HOST  SYSTBI 

>l 

>l     D«vlc»  cod»m  for  psaudo  d«vic*st 

>l 

>f      CO-  consola  dvvlc* 

>|      NL-  null  d«vic» 

>» 

>f     Ent«r  r*s>>on**ft  m*t    d«vl>nu*b*r  cor.troll«rsi>d*v2"nu*b«r  cooi/ollarsr  .», 
>t  If   »   devices  i«  s^vcifivd  without  th«  nu»b»r  of  controll*r*r  th*  nu*b»r 

>f     of  controller*  defaults  to  !• 
>f 

>l      EmmpI*:  DK»DH''2fYL»NL. 

>» 

>»  15.  Device*  CSJt  DK>OH»DT>NT>LPf YL-2f NL . 

>> 

>)  Proce*sor:il/40    He»orw  Size! 124Kf Hepped    Swute*:R8X-llS 

>» 

>l  Host  conf iduretion 

>» 

>t      1.  Is  •  line  printer  eveilsble?  CY/NJ:  Y 

>«   3.  Does  the  listin«/»ai>  device  have  at  least  120  coluansT  CY/N3!  Y 

>i   4.  Asseablw  listings  device  <ddu: )  TD:  'NL:*]  tbj: 

>t      S<  Hap  device  for  Executive  and  device  drivers  (ddu*)  CDS  SYS  J  C83S 

>l 

>$  EOS  *  Do  wou  want  toS  <CRx -continue  K-repeat  uection  E-ewit  P  pause  CS3S 

>» 

>i    Executive  Options 

>» 

>t  Answer  Y<ES>  if  the  folxowinfl  support  is  desired 

>l 

>»  6.    Executive  Coeeon?  CY/N3S  Y 

>«   7.  Meikorw  »anaae*ent  (PLAS)  dirertivesT  CY/N3S  Y 

>«   8>  Send/Receive  bw  reference  directives?  CY/N3S  Y 

>«   9.  Get  »appin«  context  directive?  CY/N3S  Y 

>t      Address  checking  support  will  be  included 

>t  I/O  rundown  support  will  be  included 

>»  IS.  Loadable  device  drivers?  CY/N3S  Y 

>»  16.  Should  the  default  for  all  applicable  drivers  be  loadable?  CY/N3S  Y 

>•  17.  Include  support  for  Aswnchronous  Suste*  Traps  (AST)?  CY/N3S  Y 

>$    18.  Include  support  for  Cancel  Selective  Harktiae?  CY/N3S  Y 

>»  1?.  Task  ter»ination  and  device  not  read<i<  »essa«es  <TKTN)?  CY/N3S  Y 

>«  20.  Power  fail  recovery?  CY/N3S  Y 

>«  22.  Larde  <20K)  Executive?  CY/N3S  Y 

>»  23.  Logical  device  assi«n«ent?  CY/N3S  Y 

>*   25.  Do  wou  intend  to  include  a  user-written  driver?  CY/N3S 

>«  30.  Executive  DebuMHinS  Tool  <XDT>?  CY/N3S  Y 

>V   32.  Include  support  for  co*Munications  products?  CY/N3S 

>«  33.  Swstei*  controlled  partitions?  CY/N3S  Y 

>«  36.  Group  Global  event  flaHs''  CY/N3S  Y 

>» 

>l      For  directivesS 

>* 

>t  *   -   Prints  the  table 

>l      •  -  TerMinates  inouiru 

>t      Z  -  Gets  all  valid  directives  and  teminates  inouirw 

>» 

>*   37.    Enter   code    for    st^sieik   directives    CS3S    t 

>t 

>|      A-  Get  partition  paraiketers    B-  Get  task  para*eters 

>l      C-  Send/Receive  D-  Alter  priority 

>l      E-  Extend  task  F-  Connect  to  interrupt  vector 

>l      G-  Get  sense  switch  H-  Set  s%<steM  ti»e 

>f      I-  Stop  bit  J-  Specifw  reauested  exit  AST 

>>      K-  Parent  offsprina  tasking    L-  Parent  offspring  tasking  with  chainins 

>» 

>t  Enter    responses    as    codt'lcode2code3.  . .    (no   comikas)    (e.fl.S    ABCOF.) 

>» 
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>•  37.  Entar  cad«  for  •w»t*»  dirvctivvu  ISlt    X 

>9   38.  Mumbmr   of   pr»-allocat»d  010  r-acktt*    CO  R:0.-1S.  DtS.li 

>•  39.  8iz«  of  d«tj  iransfor  voctor  ir>  words  CD  RIO. -33.  0S33.1i 

>•  40.  Round-robin  schodulina  intorvcl  in  ticks  CO  R:0.->000.  0:S.]t 

>«  41.  Hl«h**t  priorltw  class  for  considaration  CD  R:i.-249.  OMSO.i: 

>•  42.  Lowest  ^rlorltw  class  for  considoratlon  CD  R:i.-1S0.  0:1.}: 

><  4A.  Soconds  batwoon  prlntor  not  raadw  mm%*m»m*   CO  RtO.-2S5.  0:30.]. 

•>*   48.  Swstoa  crash  raflistar  and  stack  duop  davica  CSR  CO  RtO-177700  P:i77SA4J: 

>•  SO.  Twra  of  crash  duBP  analwsts:   A-  PANIC   B-  Crash  Ouap  Analysis  (COA)  CS]: 

>•  SI.  CDA  output  notification  davica  CSR  CO  R: 160000- 177700  0:i77S64]i 

>•  S2.  Entar  COA  aaaorw  duMP  davtca  «naaontc  (ddu: >  CS  R!3-4]:  DKO: 

>«  53.  Entar  COA  Maaorw  du»p  davica  CSR  CO  R: lAOOOO-1 77700  O: 177404]: 

>l 

>l    TarMinal    drivar   options 

>» 

><   1.  TarMinal  drivar  dastrad  (A/O/C/Oi  «  prints  tabla)  CS3:  • 

>» 

>l  Tarainal  drivars:   A-  Tailorabla  half  duplax 

>l  B-  Tailorad  half  duplax  (usar-oriantad) 

>l  C-  Full  duplax 

>l  0-  Basal ina  half  duplax 

>t 

>»   1.  Tarainal  drivar  dasirad  (A/B/C/C«  «  prints  tablv)  CSi:  C 

>•   2.  Unsolicitad  input  tiMooul  valua  in  sacorids  CD  R:0.-2S5.  01120.3! 

>l 

>)  Answer  Y(ES>  if  tha  followin*  support  it  dasirad 

>l 

>«  6.  Unsolicitad  input  character  AST^  CY/NJ:  Y 

>«   8.  Braakthrou*h  writ*''  CY/NJ:  Y 

>l  CTRL/R  support  will  ba  included 

>«  10.  Escape  saouanca  handlins''  CY/Nj:  Y 

>«  11.  Gat  aultiPla  characteristics''  CY/NJ:  Y 

>«  12.  Sat  nultiPla  characteristics''  CY/N]:  Y 

>*  13.  Get  terminal  driver  optionb''  CY/Ni:  Y 

>•  17.  Read  after  prospf  CY/Ni:  Y 

>«  20.  CRT  rubout  supporf  CY/n::  Y 

>•  2S.  Hiirdwara  unrecoverable  input  error  riotif ication''  CY/Ni:  Y 

>•  26.  Device  independent  cursor  pobi tionintf''  CY/NJ :  Y 

>l 

>•  EOS  «  Oo  wou  want  toS  ^CR>-continua  R-rareat  section  E-exit  P-pause  CS]: 

>» 

>» 

.■'i    Swstae  Options 

>l 

>l 

>l  Answer  Y(ES)  if  the  following  support  i&  desired 

>♦ 

>«    11.  What    naea   would   wou    like    to    aive    ^uur    sttsten    CO:    RSXllS]    CS   RiO-6]: 

>» 

>•  EOS  •  Oo  vou  want  to!   CR  -continue  R- repeat  section  E-exit  P-pause  CS]: 

>» 

>>  Thinking  . . . 

>» 

>t    End  of  Executive  option  generation  at  14:33:32  on  19  OCT-Sl 

>» 

>l    Peripheral    corif  la  I'^t  lor 

>» 

'it  Pardeeters   aPFearind   lo   souare   brackets   'C...!*   can   onlw  be 

>»  specified   for   the   first   controller   of   a   Particular   device. 

>l  Paraeeters  appearing  in  >  di'erithe>.es  *(..■>*  onl^j  need  be  specified 

>!  if    the   indica>:ed   optiori   is   present   ori   the   tartlet   s^stea. 

>l  The    default   for   loadable   <Jrivers   has   beeri   set   to   «TRUE«. 

>t  To  override  this  settina  enter  K  (resident)  as  the  first  r-araeeter 

>>  for     the     first     contruller    of    the    '..r-ecified    device. 

.'t 

.  I  A/O  and  Laborator'!<  devices:  None  srecified 

>t 
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>»    Int»r^roc»m»or   coMMunication  dcvicvmi   Non*   urmcitxmd 

>t 

>l  Unit  record  d*vic«»i  LP 

>» 

>»  Ent«r  CL/R.3  v«ctor.  CSRt  printer  twp«  „„„,.  ,   . 

>j  (»CKHC  tlMOut  count  <0-no  KHO »  KHC  vector.  KHC  CSR3>  fort 

>»  lA.  LP  controller  0  CDJ  200»177514.LA180f 0.300. 1401303  C83:  ..LPll-V 

>» 

>l  DisKsi  DK.  DHf  OT 

>» 

>» 

>l  For  the  third  pareaeter  of  the  next  Question,  enter  the  nuaber 

>l  of  RK05  drive*  wour  terriet  swste*  he«.   Realize  that  an  RKOSF 

>»  it  a  fixed  eedia  RK05  drive  eauivalent  to  two  reeovable  RKOS 

>)  drives.   Specify  everw  RKOSF  as  two  RKOSs. 

>» 

>l  Enter  CL/R.]  vector.  CSR.  number  of  drives  for  J 

>t 

>«   3.  DK  controller  0  CD:  220.1774043  CS3:  ..2 

>» 

>t    Enter  CL/R.3  vector.  CSR.  •  drives.  0-offset  recoverw/NO-no  offset  rec.  for: 

>«  13.  DM  controller  0  CD:  210.177440. .03  CS3:  ..2 

>«  54.  Contr  0  unit  0.  i.    an  RK06/RK07  CD:  RK063     CS3: 
>«  54.  Contr  0  unit  1.  is  an  RK06/RK07  CD:  RK063     CS3: 

:>i 

>l  Enter  CL/R.3  vector.  CSR.  number  of  drives  for: 

>» 

>«   3.  DT  controller  0  CD:  214.1773423  CS3:  ..2 

:>i 

>»  Tapes:  MT 

>  i 

:>t    Enter  CL/R.3  vector.  CSR.  number  of  drives  for: 

>> 

>«   3.  MT  controller  0  CD:  224.1725223  CS3:  ..2 

;>i 

>»  Non-phwsical  (pseudo)  devices:  CO.  ML.  TI.  CL.  LB.  SY 

>» 

>»  Terminal  interface  devices:  YL 

>l 

>t    Enter  vector.  CSR.  E=DL11-E  modem  support/NO=no  for: 

>» 

>«  21.  YL  controller  0  lD:  60. 177560. N03  CS3: 

:>«  21.  YL  controller  1  CD:  ..N03  CS3:  300.174500 

>» 

>»  EOS  *  Do  «ou  want  to:  <CR>-continue  R-repest  section  E-exit  P-pause  CS3; 

>. 

>» 

>»  End  of  interrupt  vector  area  has  been  set  to  400 

>i 

>» 

>i    Create  Executive  build  files 

>> 

>> 

>*   1.  Do  «ou  wish  to  edit  ana  of  the  Executive  files?  CY/N3: 

>» 

>«  EOS  «  Do  aou  want  to:  <CR>-continue  R-repeat  section  E-exit  P-pause  CS3: 

> » 

>> 

>f  Prepare  for  task  buildind 

>f 

>i 

>i    Clean-up  extraneous  object  files 

>i 

>» 
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>»  EOS  »  Do  wou  want  to5  <CR.>-continu»  R-r»^»>t  «»ction  P-^au*«  CS3S 

>» 

>l 

>>    End   of    IISOEN   F>hss»    I    at    14:4S:37    on    19-0Cr-81 

>)      —  To  continue  twp*:  (»C200»200]11SGEN2 

>l 

>•  <EOF> 

>911SGEN 

>» 

>>  RSX-llS  Version  4.0  BL32  SwstvM  Generation  done  on  RSX-llM 

>» 

>l  Copwri«ht  (C>  1979>1981 

>t    Digital  EauiPM*nt  Corporation^  nawnardr  Mass. 

>t  All  Ri«ht«  R»*arv»d. 

>» 

>l 

>>  RK06  distribution  kit 

>» 

X   3>  Do  wou  want  to  inhibit  axacution  of  NCR  coii»andmT  CY/Nlt 

>«   4.  Hav*  wou  Mad*  a  copw  of  the  distributior:  Kit?  CY/N]:  Y 

>*  5.  Are  wou  «en*ratinfl  a  napped  «wste»T  CY/N3:  Y 

>» 

>l  The  files  in  Cl>50]  »ust  be  deleted  in  order  to  provide 

>l  adeauate  disk  space.   The  baseline  swste*  in  Cl>54]  aust  be 

>l  the  hardware  bootable  swste*  (the  swste*  under  which  SYSGEN  is 

>t    running).   If  it  is  not*  exit  SYSGEN  bw  responding  No  to  the 

>l  next  au*stion>  (install  BOO)  and  BOOt  the  Cl>543  swsten 

>l  (BOO  ClrS4])>  SAVe  this  swstee  and  rewite  the  boot  block 

>l  (8AV  /yB)t  and  then  restart  SYSGEN  (9SYSGEN.CHD) . 

>l 

>l  If  wou  respond  Yes  to  the  next  auestion>  the  files  in  ClrSO] 

>l  will  be  deleted.   If  wou  respond  No>  SYSGEN  will  exit. 

>» 

>«  6.  Can  the  files  in  Clr503  be  deleted?  CY/NJ:  Y 

>*  7.    Use  an  input  saved  answer  file?  CY/Ni:  Y 

>»  B.  Naae  of  input  saved  answer  file  CD:  SYSSAVEO.CHD]  CS]: 

>» 

>>  Phase  I  input  saved  answers 

>l  created  on  19-OCT-ei  at  14! 19:55 

>>  bw  llSOEN  version  1.52 

>)  are  fro*  file  0M0:C200>200]SYSSAVED.CMDI2 

>» 

>»  10.  Na»e  of  output  saved  answer  file  CD:  0H0:C200»200]SYSSAVED.CND3  C83: 

>» 

>)  Phase  I  output  saved  answers  created  in  file  DH0:C200f 2003SYSSAVED.CHDI3 

>» 

>«  11.  Use  saved  host  configuration?  CY/Ni:  Y 

>*  12.  Use  saved  peripheral  configuration?  CY/N]'  Y 

>«  13.  Skip  end  of  section  (EOS)  breakpoints?  CY/Ni:  Y 

>«  14.  Skip  end  of  execution  (EOX)  breakpoints?  CY/ND:  Y 

>»  IS.  Clean  up  files  fro*  previous  GENs?  CY/Ni: 

>l 

>SET  /UlC-ClrU 

>PIP  Clr503«.»f«/DE/NM 

>PIP  /FR 

oho:  has  8054.  blocks  freet  19072.  blocks  used  out  of  27126. 

Largest  contiguous  space  «  5641.  blocks 

2121.  file  headers  are  freet  439.  headers  used  out  of  2560. 

>SET  /UIC-Cllfl03 
>» 
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>l  T«rtf*t  configuration 

>l 

>t    Proossort  11/40    M«»orM  Slzffi  124K>n«c^*d    8w«t*»:R8X- 1 18 

>l 

>|  SMitch  R*«ist«r 

>|  Floating  Instruction  8*t 

>|  ParitM  N*»orw 

>» 

>l  Host  conf IMuratlun 

>» 

>l  EMffcutiv*  Option* 

>» 

>l  Tvrainal  driver  options 

>» 

>l  Swst**  Options 

>l 

>» 

>l     ThlnKln*  ... 

>l 

>l  End  of  EMVCutiv*  option  ««n*r«tlon  at  14:91:40  on  19-OCT-ei 

>» 

>l  P«rlPh«ral  conf lauration 

>» 

>)  Paraaatars   a^paarinri   in  sauara  bracKats   *C...]*   can   onlw  b« 

>l  s^aclfiad   for   tita   first  control lar   of   a   ^articular   davica. 

>l  Paraaatars  a^paarin*  in  ^aranthasas  *(...)*  onlM  naad  ba  s^aclfiad 

>|  if   tha   indicated  option   is   ^rasant  on   tha   tar«at   swsta*. 

>l 

>|  Tha   default   for   loadable   drivers   has  been   set   to   tTRUC*. 

>l  To  override  this  setting  enter  R  (resident)  as  tha  first  ^ar-aeeter 

>»  for    the    first    controller   of    the   specified   device. 

>» 

>l  A/0  and  Laboratorw  devices:  None  specified 

>l 

>l  Interrrocessor  coaeunlcation  devices:  None  specified 

>» 

>(  Unit  record  devices:  LP 

>» 

>l  Disks:  OKt  DN»  OT 

>» 

>l  Tapes:  HT 

>l 

>l  Non-Phwsical  <pseudo>  devices:  CO?  NLt  TI?  CL>  LB>  8Y 

>• 

>l  Terainal  interface  devices:  YL 

>l 

>SET  /UIC-C1>24]  <  Creatine  TTORVBLO.CHD 

>8ET  /UIC»C11>10] 

>l  End  of  interrupt  vector  area  has  been  set  to  400 

>l 

>l 

>l  Create  Enacutive  build  files 

>» 

>PTP  R8XNC.NAC-8Y:R8XHC0.HAC/AP 

>I48  •MAC 

>AiM  8y:-lb: 
>> 

>l  8t8rt  of  Executive  asse*blM  at  14:57:^3  on  iV-OUT-Bl 

>l 

.>8ET  /UIC-C11>243 

>KAC  ff8Y:R8XA8H 

>i 
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>l    End  of   Exvcuiiv*   a%%emtilv    at    15:16:49   on    19-JCT-81 

>» 

>» 

>»    Start   of   Uvvic*   drtvvrii   «sewMt<l^j   at    1S:16:S2   on    19-0CT'81 

>» 

.>NAC  ffSYtRSXDRVASM 

>^ 

>l  End  of  Ovvic*  drxvvrb  ae3«M(<lw  at  15:2/:03  on  19-UCT-81 

>» 

>ASN  -lb: 

>» 

>t    Pr«i>«r*   for   task   t<uildinji 

>» 

>SET    /UIC-i.:f24] 

>PIP  RSX11S.0BS'C11>243«.0BJ 

.>PIP  TT0RV.0BJ»C11.24J«.TTY 

>IN8  »LBR 

>LBR  RSXl 1 S/CR : 100 . : 960 . : 1 28 . =RSX 1 1 B . DBS 

>LBR  TTDRy/CRJ30.:256.:64.»TTDRV 

>PIP  /NV-CllrlO]RSXBLO.CnD 

>PIP  Cll»103RSXBLD.CMDI«/r«E/NM 

>REH  LBR 

>l 

>l  Cl*«n-up  ffxtrancous  obJvct  files 

>l 

>PIP   R8XllS.0BS(«/1E/NMrTTDRV;.0EiJf»>t  ll>24]«.0BJ>«>*.TTy>« 

>REM   MAC 

>t 

>» 

>)  End  of  IISGEN  phas*  I  at  lS:3i:5S  on  19-0CT-8; 

>»      ~  To  continue  twpe:  (?C200»200J1 1SGEN2 

>» 

>SET  /UIC=C200»2003 

>9   <EOF> 

>BC200f 20031 1S6EN2 

>» 

>»  RSX-llS  Version  4.0  BL32  System  Generation  Phase  II 

>l 

>>    Copviriaht    (C)    1975f    1981 

>t    P>«ital    Eouipinent   Corp.r    Maunardr    MA.      01754 

>f    All  Rights  Reserved. 

>» 

>i  Build  The  Executive  And  All  Reauired  Tasks 

>» 

>i    This  command  file  will  produce  the  tariaet  system  on  your  SY:  disk. 

>t    If    it  is  an  RK05  or  an  ifx'LOlr  this  command  file  will  delete  a  number 

>»  of  files  from  th.is  disk  to  make  room  for  those  reauired  to  complete 

>}  this  IISOEN.   You  must  be  running  on  an  expendable  copy  of 

>i    your  disk.   Note  howevero  that  the  disk  will  be  left  in  a 

>>  state  such  that  RSX-llS  sys^ens  may  be  performed  at  a  later 

.>i    date.   In  additionr  the  sysilen  itself  may  be  terminated  and 

>t    may  be  restarted  at  Just  about  any  point  to  rebuild  par- 

>l  ticular  pieces  of  the  system. 

>i 

>*    In  what  UIC  is  SGNPARM.CMD  if  not  C200»200]  CS3J 

:--f    RK06  distribution  kit  IISGEN  ver«Hion  1.52  for  RSX-llM  BLJ2 

>f 

>i    Continuation  from  IISGEN  PHASE  I  done  on  19--0CT--81  at  15:31:47 

>TIM 

15t34:42  J9-0CT-81 

.:asn  sy:--lb: 

:>» 


• 
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,'t    ty;fmntimO    co»Mrrit»    provide    a    coMPlet*   description   of    evvrw    fct»p    in 

>l    thi»    IISOEN   ronnarid    fil*.       Oti    the   other    riandr    short    coAaents 

>»    provide    virtujll^i    fio    e.':p  1  snstorsi    te;t. 

>» 

>t    [lo    uou   want    expanded   coaiaents''    CY/NJ:    Y 

>l 

>l  Create  RSX-llS  subset  swstea  lit<rarw 

>l  if  woo  have  not  already  done  so> 

>» 

.>INS  SY:«LErR 

>SET    /UIC=Clfl] 

>«    Have   wou    alread%<   created    IISLIB.OLB''    CY/N3: 

>LBR    LB:ilSLIfi/CR:30.  :896.  :320. 

>REM   LBR 

>«  Have  t^ou  already  built  the  E.-^iecT  CY/Ni: 

>SET  /UIC-Clf243 

>» 

>l    Purde  Exec  build  coMMand  files  and  assemblw  prefix  files 

>» 

>PIP   RSXBLD.CMIi/PU/NM 

>PIP  C11»10JRSXHC.MAC/PU/NH 

>» 

>l  Now  we  build  the  Executive 

>l  If  Mou  Must  Make  changes  to  the  Executive  build  files 

>>  answer  wes  to  the  following  auestion.  Edit  RSXBLD.CMD 

>l  bw  issuing  the  coamand  EOI  LB:RSXBLD.CMD.  11SGEN2  will 

>>  build  the  Executive  after  <^ou  resuwe  fro*  the  pause* 

>» 

>*  Do  wou  wish  to  edit  the  Executive  build  file?  CY/NIS 

>1NS  sy:$tkb 

>TKB  9LB:RSXBL0 

>»  Did  the  Executive  build  successfully?  CY/NJ:  Y 

>SET  /UIC=Clr643 

>4i  Do  v^ou  want  to  build  an^i  loadable  drivers  now?  CY/NIS  Y 

>l 

>>  Build  Loadable  drivers 

>» 

>»      3.    Device    for   driver's   maps    CD:    NLM    CSD: 

>SET    /UIC=C1»243 

>t 

>i    The  followind  are  iknerionics  of  the  loadable  device  drivers  selected^ 

>> 

>»      DK      DH      DT      LP      MT 

>» 

>>  When  all  drivers  are  built*  strike  carriage  return« 

>{ 

>*   S«  Driver  2-character  device  mneMonic  CSIS  DK 

>»  6.    Drive  partition  name  CD:  DRVPAR3  CSJ: 

>TKB  eSY:DKDRVBLD 

>t      S.  Driver  2-character  device  nnexonic  CSJ;  DM 

>»   6.  Drive  partition  name  CD:  DRVPAR]  tS2i 

;>TKB  »sy:dmdrvbld 

>*      5.    Driver    2-character    device   nmemonic    CS3:    DT 

>«   6.  Drive  partition  name  CD:  DRVPAR3  ZS21 

:>TKB  eSY:DTDRVELD 

>*   5.  Driver  2-character  device  mnenonic  CS3:  LP 

>»  6.    Drive  partition  name  CD:  DRVPAR]  CS3: 

>TKB  eSY:LPDRVBLD 

>*   5.  Driver  2-char3cter  device  mnemonic  CS3:  MT 

>»   6.  Drive  partition  name  CD:  DRVPAR3  CS]: 

.>TKB  bsy:mtdrwbld 

>*   5.  Driver  2-character  device  mnemonic  CSJ: 
:>SET  /UIC=L  1.643 
>REM  TKB 

SET  /UIC=C1»243 
.^1 


• 
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>l  You  now  n««d  th»  EmvcuIxv*  •«!»•  to    lawout 

>l  th«  partitions  in  wour  n«w  cwat**. 

>» 

>•  Do  wou  hav*  th*  aap*  alraadwT  CY/NJ: 

>LOA  LP> 

>PIP  LPI-Clr343KSXllS.t1APfEXC0Hl.HAPfEXC0M2.HAP 

>UHL  lp: 

>» 

>l    Look  in  th*  •«!>  of  th«  Exoc  for  th*  swabol  'tSYTOP*  which 

>l  indicator  th*  last  addrass  allocated  to  tha  Exac.   Usar 

>i  partitions  mmv   start  at  anw  locatior  bawond  this  addrass 

>l  •■  lon«  as  thaw  fall  on  a  64   bwta  boundarw.  Saa  tha  RSX-llM 

>l  SwsMon  Manual  for  a  dascription  of  how  to  sat  up  partitions. 

>>  You  Maw  wish  to  stop  at  this  ti*a  to  lawout  wour  partitions. 

>» 

>*  Hav*  wou  alraadM  built  tha  full  duplax  tarainal  drivarT  CY/N3S 

>l 

>l  Now  wa  build  tha  full  duplax  tarainial  drivar 

>l 

>» 

y|  Tlia   task  build  coaaiand  fila  for  tha  full  duplax  tarainal  driva 

"•I  •'■•c'cifias  that  it  run  in  partition  TTPARf  having  a  lancth  of 

>»  4OOO0  octa' . 

>l 

>t   Do   wou  taich    to  adit    tna   build   coMMsnd   fila   for    tha   taminal    drivarT    CY/N]i 

>INS    SYUTKB 

>TKB  «lb:ttdrvbld.chd 

>»  Did  tha  taminal  drivar  build  successful  lw7  CY/Ni:  Y 

>REH  TKB 

>«  List  full  duplax  t*r»inal  drivar  »ap?  CY/NJ:  Y 

>LOA  LP: 

>PIP  LP:«Clf 343TTDRV.HAP 

>UNL  lp: 

>*  Do  wou  want  to  continue  and  build  the  privileged  tasks?  CY/N]:  Y 

>> 

>l  Prepare  to  assemble  and  build  the  RSX-llS  privileged 

>t    software  conponents. 

>» 

>>  The  tasks  TKTNf  BASMCRf  OTLr  and  SIP  Mu^t  be  assembledf  and  the 

>^    task  build  coMnand  files  possiblw  edited  before  thew  can  be  built. 

>>  Thk.  tasks  RSDVOSf  RS0VS2f  and  RSOVIH  reed  onlw  to  be  builtf  but 

>f  thair  co»*and  files  naw  also  be  edited  before  thew  are  built. 

>t    It  is  not  necessarw  to  save/print  the  asseitblw  listinMsf 

>>  However f  we  recoaMend  that  wou  save/print  the  task  build 

>!  Maps.   This  is  especiallw  iMPortant  when  aeneratind 

>>  an  unaappcd  swsteM  --  without  Maps  it  will  be  difficult 

>l  to  deterMine  partition  liMitg. 

>» 

>«  AssaMblw  list  device  for  privileged  tasks  (DDNN:>  CD:  NL:]  CSJ: 

>»  Hap  device  for  privileged  tasks  (DDNNS)  CD:  SY:]  CSI: 

>»  Have  wou  alreadw  built  task  TKTN7  CY/NJ: 

>» 

>>  Task  TKTN  will  be  included  in  wour  IIS  swsteM  as  a    result 

>t    of  wour  selection  in  IISGEN  Phase  I. 

>» 

>» 

>l  The  privileged  tasks  BASHCRf  OTLf  and  SIP  were  speciallr^  designed 

>»  for  use  in  the  RSX-llS  t?nvi  roriMent .   Their  inclusion  in  the  sast«'!» 

>t    is  optional.   If  desiredf  thew  will  be  asseMbled  and  built  under 

>l  control  of  this  coMMand  file. 

>» 

>«  Do  wou  wish  to  include  BASHCR*  OTLr  or  SIP  in  wour  swaten'^'  CY/Ni:  Y 
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.   )     Die    tdj.l'S    KSlil^Cto     KSIil^S;J>     dii<J    KSDtJlH    (J<jM.iiti  icdl  1>J    dlbF-ld'j    th« 

>l    the    &tdtij<>    of    mvmovii    on    d    s<r<iH)iic  u    turmxridl    jnd    cdii    ti*    built 

>l    for    th»    VT05FI    terminal  »    VT'jJ    t«riiiinjl»    and    yilOO    terimnal 

>l    reb^ect  ivvlti .       These    td&l'<>    displd>i    wl^iich    tdt>l<%    are    m    iiieihur>^ 

>l    «nd    where    in    neniorw    theu    rebidur    which    tdst-     is    currently 

>l    rurminslt    and    the    status    of    tool, 

>» 

>*    Ho    «ou   want    to    include   RSliV05»    RSriV52»    or    RSDWIH'''    CY/N3S    Y 

>l 

>l    The    RSX-llS    subset    file    control    services    (FCS)    are    dlst- 

>l    ributed    as    a    siridle    file   c-ontamind    the   concateiidted   object 

>>    modules.       They    cannot    be    t'laced    iri    the    RSX-llM    <i>jsteiii    object 

>»  libratu  (SYSLIB.OLB)  .   However»  users  who  reouire  this  FCS 

>l  should  link  with  the  RSX-llS  subset  of  SYSLIB  < 1 ISLIB.OLB) 

>»    created   dunned    this    S«saeri. 

>» 

>*  Do  aou  wish  to  include  the  RSX-llS  subset  FCS''  CY/N3:  Y 

>l 

>>  If  you  have  previously  done  an  RSX-llS  Susslen  on  this  disMf  ell 

>l  of  the  files  were  transferred  to  the  UFD  C2»20].   These  were 

>t    optionally  deleted  by  the  Sysaeri  nrocess.   Thereforer  unless 

>l  it  was  specified  to  delete  the  files  or  they  were  later 

>)  deleted  independently >  there  is  no  need  to  copy  all  of  the 

>»    files   from    the    release   kit    asiain. 

>» 

>«  Do  you  have  to  copy  the  files  from  the  release  kit?  CY/NJ:  Y 

>«  Enter  device  and  unit  of  RSX-llS  distribution  kit  (DDNN:)  CS3:  DKO! 

>» 

>l  Place  the  RSX-llS  release  kit  cartridge  disk  in  drive  DKO; 

>» 

>»  Is  the  disk  ready  m  drive  DKO:?  CY/N3:  Y 

>*  Does  the  driver  have  to  be  loaded?  CY/ND: 

>SET  /U1C=C2»203 

>INS  SYJ»UFD 

>UFD  SY:C2r203 

>REM  UFD 

>PIP  «.«J*/DE/NM 

>MOU  DKO:ilSKITl 

>pip  sy:=dko: 

>0M0  OKO: 

DMO  --  TTO:     dismounted  from  DKO:     «»»  Final  dismount  initiated  *»« 

16:21 :0V   «««  DKO:  --  Dismount  complete 

>SET  /UIC=C11»103 

.>INS  sy:»ufd 

>UFD  SV:CllflOJ 

UFD  —  Directory  already  exists 

>REM  UFD 

>«  Do  you  wish  to  make  corrections  to  RSX-llS  source  modules?  CY/N3J 

>INS  sy:«mac 

>SET  /UIC=Clf243 

>MAC  BTKNASM 

>PIP  TKNASM.CMDf«/DE 

>REM  MAC 

> » 

>i    The  task  build  command  file  for  TKTN  specifies  that  it  run  in 

>»  partition  SYSPARr  havjna  a  lenath  of  3700  octal. 

>f    If   you  must  chanae  the  partition  name  or  lenath* 

>;  you  will  have  to  edit  its  task  build  command  file. 

>i 

>*   Do  you  have  to  edit  the  task  build  command  file  for  TKTN?  CY/N3; 

>iNS  sy:»tkb 

; TKB  eTKNllSBLD.CMD 
,REM  TKB 
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>l  BASMCR  IS  a  privilffKcd  tcsK  which  suppIiws  a  subset  (or  basic 

>l  s«t)  of  th*  RSX-UM  NCR  comnands.  It  can  not  bm    includffd  if 

>t  during  Swsflsn  Phasv  I  wou  indicated  that  tjou  did  not  want  anw 

>l  temlnal  devices.   Its  size?  de^endinii  u^on  optionsr  ranges 

>l  fro*  6400  to  13700  octal  on  Mapped  swsteMS. 

>» 

>*  Do  wou  want  to  Include  tasN  BASMCR?  CY/N3:  Y 

>IN8  8Y:«UFD 

>UFD  SY:C16rlOJ 

>UFD  8Y:C16f243 

>REH  UFD 

.>8ET  /UIC-C16>10] 

>PIP  BHPRE.HAC»«/DE/NM 

>PIP  «.HAC»«/RH/NM 

:>PIP  C16»«]«.«I«/DE/NM 

>PIP  C16>10]«C2t20aBMPRE.HAC 

.>PIP  C16f  IO]/EN-C2f20]AliOBA8.^AC>ATLBAS>BRKBASfERRBA8>ERRMSG 

>PIP  C16f 103/EW-C2f203FMTDV.MAi:.FNDUCB»0NBLK.GETNUM»KEYMD 

>PIP  C16>10]/EN-C2f20]LKLST.t1ACrMCRBASrOPEBASfPRSBAS>REDBAS 

>PIP  C 16> 103/EN-C2 > 203REHBAS . MAC r RPSBAS>RUNBAS > TIMBAS 

>SET  /UIC>C16f24] 

>t 

>t    The  size  of  BA8IC  NCR  is  dependent  upon  the  inclusion  of 

>t  conditional  assenblw  code.   The  inclusion  of  the  code  is 

>l  controlled  bM  sw*bol  definitions  appearing  in  an  asseablw 

>t    prefix  file.   The  default  for  these  conditionals  is 

>l  exclusion.   The  following  optionsr  alon«  with  the  corres- 

>>  pondinfl  control  swiibolsr  are  available. 

>l 

>|       R«»ATL  -  ATL/TAL  COHMANDS 

>>       RttERM  -  ERROR  MESSAGE  TCXT 

>f       Rt«OPE  -  OPEN  COMMAND 

>» 

>l  To  include  an  option  locate  the  desired  conditional  swubol 

>l  and  remove  the  senicolon  at  the  beflinnintf  of  the  line.   For 

>l  ffxaapleS 


>» 

>l 

»PL    IR«»ATL 

>l 

»R*«ATL    *    0 

>t 

»C    /»// 

>» 

R»*ATL    =    0 

>l 

« 

>» 

> INCLUDE  ATL 


IINCLUOE  ATL 


>l  Rwpeat  this  for  all  desired  options.   Note  that  the  swmbols 
>>  appear  on  consecutive  lines  in  alphabetical  order  in  the  file. 

>» 

>»  Do  wou  wish  to  edit  the  asseiablu  prefix  file  for  BASMCR?  CY/NJ:  Y 

>INS  sy:«edi 

>EOI  C16>10]BMPRE.MAC 
C00029  lines  read  in3 
CPa<e     13 
«PL  »R««ATL 
»R»«ATL  =        0 
«C  /I// 

RttATL  "  0 

«PL  IR*«ERM 

;r»«erm  °      0 

«C  /»// 

R»»ERM   =        0 
«PL  >R»«OPE 
«R««OPE  =        0 


«C  /»// 
R»«OPE 
«EX 
CExit] 


}  INCLUDE  ATL 

;  INCLUDE  ATL 

;  INCLUDE  ERROR  MESSAGES 

)  INCLUDE  ERROR  MESSAGES 

;  INCLUDE  OPEN 

;  INCLUDE  OPEN 
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.>REM  EDI 

>INS  SYStnAC 

>iiAC    9BA8HCRASM.CMD 

>REH   HAC 

:>8ET  /UIC-Clf24] 

>PIP  C16>10]BHPRE.MACI«/OE/NM 

>PIP  ClAf 10J«.HACI«/RM/NH 

:>PIP  BA8NCR.0BJ-C16>243«.0BJ 

>P1P  C16>24J«.«(«/DE/NH 

>IN8  sy:«lbr 

>LBR  BAShCR/CR  i  21 . : 64 . : 64 . ^BASHCR 

>REH  LBR 

>PIP   BA8HCR.0BJI«/DE/Nf1 

>» 


Th«  task  build  co»*and  film   for  BASHCR  sp«cifi*s 
run  in  partition  HCRPAR>  l»n*th    13700  octal  (Mapp 
If  wou  •ust  chantfa  tha  partition  naaia  or  lanMthr 
wou  will  hava  to  adit  it*  task  build  co»*and  fill 


>l  Tha  taak  build  co»*and  fila  for  BASHCR  spacifias  that  it 

.>!  run  in  partition  HCRPAR>  lanath  13700  octal  (Mappad). 

>l 

>l 

>» 

>«  Do  Mou  with  to  adit  tha  ta*K  build  coaaand  fila  for  BASHCRf  CY/N3t 

>IN8  8r:»TKB 

>TKB  tBASHCRBLD.CHD 

>REM  TKB 

>» 

>l  OTL  is  a  privilariad  tasK  which  i*  tha  R8X-11S  on-lina  taak  loadar. 

>>  It  parforas  tha  install r  load>  and  fix  functions  for  tasks  which 

>l  wara  craatad  on  a  host  davalop»ant  swstaa  and  copiad  via  FLX  to  a 

>l  load  MadiuMt   Oapandina  on  tha  nuabar  of  load  davicasf  atcf  OTL 

>l  ranflas  fro*  8000  to  ISOOO  octal  on  aappad  swstaasi 

>» 

>«  Do  wou  want  to  includa  task  OTL?  CY/NJ:  Y 

>iN8  sy:«ufd 

>UFD  SYtC20>10] 

>UFO  SY:C20f243 

>REM  UFD 

>8ET  /UIC-C20fl03 

>PIP  SV:OTLPRE.HACI«/DE/NM 

.>PIP  8Y:».HAC»«/RH/NM 

>PIP  C20>«3«.«i«/DE/NH 

>PIP  C20fl03»C2f2030TLPRE.MAC 

.>PIP  C20f 10]/EN=C2F2030TL.MAC»OTLCDfOTLCMfOTLERR 

>PIP  C20»103/EN-C2.20]0TLHD.HAC.0TLLB.0TLLD.0TLQI0.0TLRD 

>SE1  /UIC-C20p24J 

>! 


>» 
>» 
.>l 
>» 
.>» 
>» 
>» 
>» 
>» 
>« 
>» 
>» 
>» 
>J 
>l 
>l 
>» 
>» 

:>i 
>» 

>» 
>» 


Tha  siza  of  OTL  is  dapandant  upon  tha  inclusion  of  conditional 
assaablw  coda.   Tha  inclusion  of  tha  coda  is  dona  in  two  waws> 
bw  a  slnal*  swabol  dafinition  and  bw  aacro  calls  appaarin* 
in  an  assaablw  prafix  fila.   Tha  first  controls  tha  inclusion 


includa  this  optiont  locata  tha 
tha  saaicolon  froa  tha  baainninfl 
for  error  aasssaa  ta>:t  is  axclusion. 


of  arror  aassaaa  taxt.  To 
swabol  Rt9ERM>  and  raaova 
of  tha  lina.  Tha  dafault 
For  axaapla* 

*PL  >R*«ERH 
>Rt«ERM<=0 
»C  /»// 
R««ERM»0 


Tha  othar  twpa  of  option  concarns  the  exclusion  of  unwanted 
device  support.   For  each  of  the  OTL  load  devicek  which 
were  included  in  Svsaen  Phase  It  corresponding  support  will 
Generated  in  OTL.   Naturallw>  support  will  not 
those  OTL  load  devices  which  were  not  included 
The  followina  devices  alona  with  correspondina 
ma^   be  supported  bw  OTL. 


be 
for 


be  generated 
in  Sweden  Phase 
control  swabols 


I. 
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>|       PRll  -  PAPER  TAPE  READER 

>f       RXll  -  RXll  FLEXIBLE  DISK 

>f       RX21  -  RX2U  FLEXIBLE  DISK 

>|       TAll  -  CASSETTE  TAPE 

>f       TCll  -  DECTAPE 

>«       THll  -  TH/TMA/TMBll  HAOTAPE 

>|       rsil  -  TS04  MAHTAPE 

>l       TU16  -  TJ/TUU16-4S  MAGTAPE 

>f       TUS8  -  TUS8  CARTRICE 

>l 

>l  To  vxclud*  OIL  mupport  for  »   dttvic*  which  has  b*»n  d»n«r«t*d  into 

>l  wour  RSX-llS  Exacutivvr  local*  th*  corrcspondinU  davic*  twiibol 

>l  and  Plac*  a  saMicolon  at  tha  badinninri  of  tha  lina.   For  a>4a*pla: 

>l 

>l       «PL  PRU 

>|  INCLUD      PRllrP««Rll  JPCU/PRU    SUPPORT 

>f  «C   //»/ 

>|       I        INCLUD   PR11>P««R11      IPCll/PRll  SUPPPRT 

>l       » 

>» 

>l  Parfor*  thla  for  all  of  tha  abova  davicas  which  will  ba  r>art  of 

>l  wour  RSX-llS  Exacutivar  but  for  which  wou  do  not  want  OTL 

>i  auF^ort.   Nota  that  tha  sw»bol«  ap^aar  on  consacutiva  linas  in 

>t    al^habatical  ordar  in  tha  fila< 

>» 

>«  Do  wou  wi«h  to  adit  tha  assa*blw  ^rafix  fila  for  OTL'^  CY/Ni:  Y 

>INS  SYttEDI 

>EDI  CZOrlOJOTLPRE.MAC 

C00034  linai  raad  in] 

CPa«a    03 

«PL  IR««ERM 

C00034  lina*  raad  in3 

C00034  linas  raad  in] 

tR««ERH-0 

«C  /»// 

R««ERH>>0 

«EX 

CExit] 

>REH  EDI 

>INS  SY:«nAC 

>MAC  90TLASM.CMD 

>REM  MAC 

>SET  /UIC-Clr24] 

>PIP  C20»10]0TLPRE.MAC»«/0E/NM 

:>PIP  C20tlO]*.MAC>«/RM/NM 

>P1P  0TL.0BJ-C20»24]».0BJ 

>PIP  C20»24]».«I«/DE/NM 

>INS  sy:»lbr 

>LBR  0TL/CR:21.$128.:64.=0TL 

>LBR  0TL-C2r20]BLXI0M 

>REM  LBR 

>PIP   OTL.OBJM/DE/NM 

>» 

>>  Tha  task  build  coKisand  file  for  OTL  specifies  that  it 

>l  run  in  partition  OTLPAR»  lanflth  ISOOO  octal  <»appad). 

>t    If  wou  Miust  change  the  partition  naae  or  lentlthr 

>)  wou  will  have  to  edit  its  task  build  coMMand  file. 

>l 

>«  Do  wou  wish  to  edit  the  task  build  coiaiKand  file  for  OTL?  CY/N]: 

>INS  sy:«tkb 

>TKB  eOTLBLD.CMD 

>REM  TKB 

>» 
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>»    SIP    is    a    privil»ae«J    td»l<    which   PftrTormm    the   RSX-llS   swiitwm 

>»    XMAil*   preservation   duties.       It    replaces    the   RSX-llM   SAW   MCR 

>»    comi»and>       Depending   on    the   numtier   of    load   devices*    etc»    SIP 

>l    ranHes    from    3700    to    7400   octal    on   napped   swstens. 

>> 

>•  Do  wou  want  to  include  task  SIP'  CY/N]!  V 

>1NS  sy:»UFD 

>UFIi  SY:C21fl0J 

>UFD  SY:t21»24J 

>REM  UFD 

.>SET  /UIC  =  L21.10J 

>PIP    SVSSIPPRE.MAC»»/IiE/NM 

>pip  sy:«.mac»«/rm/nh 

>PIP  C21t«3«.«l«/DE/NM 

>PIP  C21»103-C2f20aSIPPRE.MAC 

>PIP  CTlf 10]/EN-«C2»20]SIP.MACrSIPB00fSIPCD»SIPERR 

>PIP  C21»103/EN"C2»203SIPLD.MAC»SIP0I0 

>SET  /UIC«C21.24] 

>» 

>t    The  size  of  SIP  is  dependent  upon  conditional  assemblu  code 

:>l  in  exactlM  the  same  wanner  as  OTL.   There  are  onlw  a  few  ninor 

>J  differences.   OTU  supports  the  paper  tape  reader  usina  the 

>»  control  swMbol  PRllJ   SIP  on  the  other  hand  supports  the  paper 

>l  tape  punch  usinM  the  control  swmbol  PPll.  In  addition!  OTL 

>>  supports  DECtape  II  cartrides  i<sin!l  control  sumbol  TUS8  and 

>)  TSll  Magnetic  tape  drives  usind  the  control  s<:<Mbol  TSll. 

>» 

>»  Do  wou  wish  to  edit  th  '  assenblw  prefix  file  for  SIP?  CY/N3:  Y 

>iNS  sy:«edi 

>EDI  C21»103SIPPRE.MAC 
C00034  lines  read  in3 
CPa^e     03 

»PL  IRttERM 

C00034  lines  read  in3 

)R««ERf1»0 

»C  />// 

RftERM^O 

«EX 

CExit3 

>REM  EDI 

>INS  sy:«mac 

>NhC  OSIPASH.CMD 

>REM  MAC 

.>SET  /UIC=LlF24a 

>PIP  C21.103SIPPRE.MACf«/DE/NM 

>PIP    C21»103«.MAC}«/RM/NM 

:>P1P   SIP.0BJ=i:21f243«.0BJ 

:>PIP    C21»24]«.«»«/DE/NM 

>INS    SYULBR 

>LBR    SIP/CR:20.:A4.  :64.--SIP 

>REM    UBR 

:>PIP    SIP.OBJ»«/DE/NM 

>t 

>f    The  task  build  command  file  for  SIP  specifies  that  it 

>i    run  in  partition  SIPPAR»  lendth  7400  octal  (mapped). 

>i    It   wou  must  chande  the  partition  name  or  lenflth* 

>l  wou  will  have  to  edit  its  task  build  command  file. 

>» 
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«  Do  wou  Hi«h  to  vdit  the  t«sK  build  co»»«nd  fil*  for  SIP''  tY/N]> 
>INS  SV:«TKB 
>TKB  VSIPBLO.CMD 
>REn  TKB 

>SET  /UIC-Clf24] 

>PIP  RHD.0LB/NV-C2>20]Rn0NAP.0LB 
>«  Do  wou  went  to  includ*  task  RSOVOS'^  tr/M2t 
>•  Oo  wou  want  to  include  task  RSDVS2''  CY/NJ:  Y 
>l 

>l  Th«  ta*K  build  cosacnd  fil*  for  R8DVS2  «p*cifi»r.  thai  it 
>l  run  in  partition  RSDV32f  l*n«th  40000  (octal). 
>l  If  wou  Must  chanM*  th»  partition  na«*  or  Ivnfltht  wou 
>l  will  hav*  to  vdit  th*  task  build  coMKand  fil*. 
>l 

>«  Do  wou  wi*h  to  adit  tha  ta*k  build  coaaand  fila  for  RSD\/52''  CY/Ni: 
>«  Do  wou  want  to  include  tamk  R8DV1H''  CY/Ni: 
>IN8  SV!»TKD 
>TKB  tRS?>VS2BLD.CHD 
>REK  TKB 
>» 

>l  Add  *ubmat  PCS  to  the  RSX-llS  sw«t»»  object  librarw 
>» 

>8ET  /UIC-C1>1] 
>IN8  SYttLBR 

>LBR  LB:il8LIB/RP-C2r20]PCSllS 
>RE»1  LBR 

>PIP  LB:118LIB.0LB/PU/NH 
>» 

>l  Support  for  the  Set  Ti»e  directive  was  chosen  in 
>t    Swstfen  Phase  I.  Produce  the  SETTIM  object  Module. 
>» 

>8ET  /UIC-Clf24] 
>IN8  ST : •MAC 
>MAC  98ETTinASH 
>PIP  SETTIMASM.CMD»«/DE 
>REH  MAC 

>8ET  /UIC-Clf64] 
>PIP  «.«/PU/HM 
>PIP  C1»243«.«/PU/NH 
>» 

>l  The  operation  left  to  be  perforned  is  that  -of  the  final 
>>  configuration  of  the  virnin  executive  usina  V^irtual  HCR< 
>» 

>*  Do  wou  want  to  configure  the  Exec  at  this  ti*e  using  VNR?  CY/N3t  Y 
>» 

>»  The  contents  of  wour  RSX-llS  release  kit  currently  resides 
>»  under  the  UFD  C2f203.  If   wour  SV:  disk  is  not  an  RKOA/07  or  an 
>i   RP04/0S/06  wou  Maw  want  to  delete  these  files.   Leaving 
>l  the*  on  the  disk  will  save  the  ti*e  of  re-copwinfl  the*  the  next 
>»  ti*e  wou  perfor*  an  RSX-llS  Sws«en.   If  wour  SY:  disk  is  an  RKOSt 
>f  thew  will  be  automatically  deleted. 
>» 

>»  Oo  wou  want  to  delete  the  RSX-llS  kit  fro*  this  disk''  CY/Ni: 
>» 

>l  Ue  will  now  aake  a  copy  of  wour  target  swstem 
>» 
>P1P  RSX11S.SYS/NV/C0/BL:49B.=RSX11S.TSK 

>» 

>i    If  wou  wish  to  make   a   copw  of  wour  task  or  swste*  i*age  file 

>l  on  another  device  we  will  pause  now  to  allow  wou  to  do  so. 

>» 

>*  Do  wou  wish  to  copw  wour  swstem  to  another  device?  CY/ND5 

.>f 


# 
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>» 
>l 

>f 
>» 
>» 

;>» 
>» 
>i 
>» 
>i 
>i 
>♦ 
>» 
>» 
>» 
>i 
>» 
>i 
>» 
>i 
>» 
>t 
>t 
>i 
>» 
>i 
>i 
>» 
>i 
>i 
>i 
>» 
>i 
>i 
>i 
>» 
>» 
>♦ 
>.* 
>i 
>» 
>» 
>» 
># 
>i 
>i 
>» 
>» 
>» 
>i 
>» 
>» 
>j 
>{ 
>t 
>f 
>t 
>» 


>l 


RSXUS.TSK  i«  a  t>«ckup  ca^w  of  the  IIS  svst**  wou  hav*  Ju»i  buiitt 
If  Mou  do  not  wish  to  rvtain  itf  w«  will  d*l*t*  it  now. 

Do  wou  wimh  to  d»i*te  the  »w«t*M  backup  fil*  RSXUS.TSK'^  CY/N]: 

Your  tarMat  •w»ta»  is  now  raadw  to  &et  up  partitions  and  install 
the  r^auirad  tasks*   The  r-rocedura  to  follow  is: 

1)  Run  Virtual  MCR 

2)  Extend  POOL  space  to  base  of  first  partition 

3)  Set  UP  wour  partitions 
3B)  Load  needed  drivers 

3C>  Set  UP  a  partition  for  the  Directive  Co»»on 

4)  Install  tasks  (tfASHCR>  OTLf  SIPf  TKTN) 

5)  rix  tasks  into  (virtual)  »enorv< 

6)  Optional Iw  set  the  tiMe  and  save  a  copw  of  THE 
swstein  on  a  bootable  Mediu* 

7)  E«it  fro«  virtual  MCR  and  boot  in  wour  target  swsteM 


VMR  exanple: 

>VHR 

ENTER  F 

VHR>SET 

WMR>SET 

WHR>SET 

WHR>SET 

VMR>INS 

VMR>SET 

VNRMNS 

VMR>SET 

VMR>SET 

VHR>SET 

VMR>SET 

yHR>SET 

WMR>SET 

WHR.>SET 

VHR>LOA 

VMR>INS 

yMR>FIX 

VNR>INS 

WHR>FIX 

WMRMNS 

WMRJFIX 

VMR>INS 

WMR>FIX 

VHR>INS 

VMR>FIX 

WMR>TIM 

VMR>SAV 

yf1R>-2 


•  RUN  VIRTUAL  NCR 
ILENAHE:RSX11S.SYS   I  VMR  PROHPTS  FOR  FILE  NAME 
/POOL=XXX        !  EXTEND  POOL  TO  FIRST  PARTITION  BASE 
/MAIN-TTPARJXXX:XXXJTASK   fSET  UP  FULL  DUPLEX  TT  PARTITION 

/hain=drvpar: XXX : XXX : TASK  •  set  up  driver  partition 
/MAiN=Exconi:xxx:xxx:coN  >   set  ist  exec,  common 

EXCOMl  'INSTALL  1ST  EXECUTIVE  COMMON 

/MAIN>EXC0M2:XXX:XXX:C0M   !  SET  2ND  EXEC.  COMMON 
EXC0M2  ! INSTALL  2ND  EXECUTIVE  COMMON 


/MAIN°SYSPAR : XXX : XXX  t  TASK 
/MAIN=MCRPAR : XXX I XXX : TASK 
/MAIN^OTLPAR : XXX : XXX : TASK 

/hain^sipf^r: XXX : XXX : TASK 
/main=rsdvs2: xxx : xxx : task 
/main=6en:xxx:xxx:sys  i 


!  SET  UP  TKTN  PARTITION 
!  SET  UP  MCR  PARTITION 
!  SET  UP  OTL  PARTITION 
'  SET  UP  SIP  PARTITION 
!SET  UP  RSDV52  PAR 
IF  SYSTEM  CONTROLLED  PAR. 


/main=6en:xxx:xxx:task  >   if  user  controlled  partition 


xx: 

TKN 

TKTN 

BASMCR 

nCn •  •  * 

OTL 

OTL 

SIP 

SIP 

RSDVS2 

RS0VS2 

10:45  11/10/77 

ox:rsxus 


LOAD    XXDRV 

INSTALL  TASK  TERMINATION  TASK 

FIX  INTO  MEMORY 

INSTALL  BASIC  MCR 

FIX  INTO  MEMORY 

INSTALL  ONLINE  TASK  LOADER 

FIX  INTO  MEMORY 

INSTALL  SYSTEM  PRESERVATION  TASK 

FIX  INTO  MEMORY 
! INSTALL  RSDV52 
•riX  INTO  MEMORY 

I  SET  TIME  AND  DATE 

!  SAVE  SYSTEM  ON  RXOl  FLOPPY 

!  EXIT  FROM  VIRTUAL  MCR 


End  of  VMR  e>:a*Ple 


Now  we  will  run  Virtual  MCR  so  that  wou  iii«iw  initialize 
wour  swstem.   Be  sure  to  define  all  reauired  partitions 
at  this  tine!  because  the  SET  function  is  not  supported 
in  RSX-llS  BASIC  MCR.   Further»ore»  if  wou  plan  to 
include  BASIC  MCR  and  OTL  in  wour  swsten*  thew  Must 
be  installed  and  fixed  into  »e*orw.   Other  tasksf 
Sfjch  as  SIP  arid  TKTN  Maw  be  loaded  into  a  running 
RSX-llS  swstei*  usind  OTL. 
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>f  note:    Sines   LOAD   and   UNLOAH   sr*   not   •uM>ori«d   on 

>t  •    running   R8X-118   kMstciiif    ell    r*auir*d    loadable 

>l  drivars   musI    bm    loadad   u«iri<   VHR. 

>l 

>l       note:  You  hav«  r«au*»t*d  to  Includa  tha 

>f       diractlv*  coM*on.   You  i»u*t  install  tha 

>t  co*»on  prior  to  axittin*  Virtual  HCR 

>l       or  wour  RSX-llS  »w»t«ft  will  not  boot. 

>IN8  SYUVNR 

>VHR 

Entar  filanaaa:  RSX118 

VNR>SET  /POOL-* 

VHR>8ET  /naim-ttpar:«:ia4:task 

VNR>LOA  TT: 

VHR>8ET  /H^XN-DRVPARt«)«:6Y8 

VHR>LOA  DKt 

VHR>LOA  DHt 

VNR>LOA  OTi 

VNR>LOA  NT: 

VHR>LOA  LP: 

VHR>8ET  /T0P-DRVPAR:-« 

VHR  —  «0IAO«-Inttallad  ta«k«  ••«  no  lonaar  fit  in  partition 

VNR>8ET  /NAIN>EXC0Ni:«:20O:C0N 

VHR>IN8  EXCOHl 

VHR  —  tDIAOt-Partition  raducad  to  axacutiva  coaaon  miza 

VNR>8ET  /NAIN-EXCOH2:ii:200:COH 

VHR>INS  EXC0H2 

VHR  --  tDIAGt-Partition  raducad  to  axacutiva  coaaon  siza 

VNR>8ET  /NAIN-8YSPAR:»:37:TASK 

VHR>8ET  /NAIN-NCRPAR:»:137:TA8K 

VHR>SET  /hain-otlpar:«:iso!Task 
VHR>SET  /haim-8ippar:«:74:task 

VHR>SET  /i1AIN-R8DV52;*:400:TASK 

vhr>8Et  /nain>oen:«:«:sys 
vnr>in8  tkn 


VHR>FIX 

TKTN 

VHR>IN8 

BASHCR 

VNR>FIX 

HCR... 

VHR>INS 

QTL 

VHR>FIX 

OTL 

VNR>INS 

SIP 

VHR>FIX 

SIP 

VHR>INS 

RSDVS2 

WHR>F1X 

RSDVS2 

VNR>REA 

RSDVS2  1 

TTi: 

VHR>REA 

RSDVS2  2 

TTi: 

VHR>RUN 

RSDVS2 

VHR>TIH 

17130  IV- 

■OCT-81 

VHR>SAV 

HH 1  :  n  S 

WHR>''Z 

>l  yhan  this  coaaand  fila  coaplatasp  uour  RSX-llS  swstaa  is 

>>  raadw  to  runt 

>» 

>REH  ...VHR 

>SET  /UIC»C200.200D 

>TIH 

17:35:44  1?-OCT-01 

>» 

>•  <E0F> 

> 

> 
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SYSGEN  DIALOGUE  PROM  AN  RSX-llM-PLUS  HOST  SYSTEM 


fi.l   INTRODUCTION 

This  chapter  contains  the  actual  terminal  dialogue  from  an  RSX-llS 
system  generation  on  an  RSX-llM-PLUS  host. 

For  the  most  part,  the  dialogue  and  procedures  in  Phase  1  are  the  same 
as  those  for  an  RSX-llh  host.  For  detailed  explanations  of  the  Phase 
1  system  ge:  er-^tlon  questions,  see  the  RSX-llM  System  Generation  and 
Installation  Guide. 

The  system  generated  in  the  example  in  this  chapter  supports  the 
following  hardware  configuration  for  a  PDP-11/23  processor: 

64K  memory 

fiO  cycle   line  clock 

1  RL02  disk  cartridge  controller  with  2  drives 

1  RK07  disk  cartridge  controller  with  2  drives 

1  null  device  driver 

1  LVll  line  printer  controller 

1  TU58  DECtape  II  controller  with  2  drives 

1  DLll  terminal  interface 

The  following  software  support  is  included: 

•  Large  {20K)  RSX-llS  Executive 

•  Support  for: 

Memory  parity 

Memory  management  directives 

Send/receive  by  context  directives 

Get  mapping  context  directive 

Address  checking 

I/O  rundown 

Loadable  device  drivers 

ASTs  and  Cancel  Selective  Marktime 

Power  fail  recovery 

Logical  device  assignments 

Group  global  event  flags 

Get  partition  parameters  directive 

Get  task  parameters  directive 

Alter  priority  directive 
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•  TKTN 

•  XDT 

•  System-controlled  partitions 

•  CDA  for  crash  dump  analysis  on  host  system 
e  RSDVIH 

•  Basic   MCR  with   support   for   OPEN,   ATL/TAL,    and    full 
error-message  text 

•  OTL  with  support-  for  full  error-message  text  and  for  all   OTL 
devices  generate.'  into  the  RSX-llS  system 

e  SIP  with  support  for  full  error-message  text  and  for  all  SIP 
devices  generated  into  the  RSX-llS  system 

e  Full-duplex  terminal  driver 

e   RSX-llS  Subset  File  Control  Services  (PCS) 

The  system  generation  is  being  performed  on  a  baseline  RSX-llM-PLUS 
VI. 0  system,  using  the  MCR  command  line  interpreter.  The  RSX-llS 
release  kit  media  are  two  RKOSs  labeled  llSKITl  and  11SKIT2. 

Questions  calling  for  a  YES/NO  answer  can  be  answered  by  pressing  the 
RETURN  key  for  a  "NO"  answer. 

You  can  also  answer  questions  asking  for  a  value  and  displaying  a 
default  value  by  pressing  the  RETURN  key  to  specify  the  default  value. 


Notes: 


1.  You  may  want  to  do  a  preliminary  system  generation  before  you 
do  your  actual  SYSGEN.  To  do  a  preliminary  SYSGEN,  you 
invoke  the  command  file  for  Phase  1  of  the  SYSGEN  (011SGEN) 
and  answer  YES  to  the  question,  "Do  you  want  to  inhibit 
execution  of  MCR  commands?" 

Phase  1  continues,  but  the  answers  you  give  to  the  questions 
are  placed  in  a  saved  answer  file  instead  of  being  used 
immediately.  When  Phase  1  finishes,  you  reinvoke  11SGEN.CMD 
to  run  the  phase  again.  This  time,  you  do  not  inhibit  MCR 
command  line  execution  and  the  SYSGEN  procedure  uses  the 
answers  in  the  saved  answer  file. 

Doing  a  preliminary  SYSGEN  saves  time  and  prevents  mistakes. 
The  sample  dialogue  in  Section  fi.2  shows  a  preliminary  SYSGEN 
being  done  before  the  actual  SYSGEN  is  done. 

2.  During  Phase  1  of  the  system  generation  procedure,  11SGEN.CMD 
asks  for  the  device  configuration  of  your  system  and  also 
which  system  directives  you  would  like  in  the  Executive.  In 
both  cases,  you  can  print  out  a  table  of  the  available 
options  before  you  answer  the  question. 
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6.2   ACTUAL  DIALOGUE— RSX-1 IS  SYSTEM  GENERATION  ON  AN  RSX-llM-PLUS  HOST 


MOII  DMt  :rsxiis 
ASN  omi:==sy; 

SET    /IJIC  =  [  2r2001 

UFD    DMl  ;C.'f200] 
>MOll    UKSllSKITl 
'PIP    /NU«riMC2.20111SGEN.CM£i 

riMO    DKS 
DMO     --    TTO:  IiTSMOUNTi:ri    FROM    PKO:  ♦♦«    f  INAL     HISMOUNT    «»* 

10:29:14       «««    DKOt        -       DISMOUNT    COMF'l  ETE 
-BllSGEN 
>> 

RSX-ltS   Ver^iori    4.0    Eil.;J2    System    riprier,it  ion    dcirn?    on   ftSX    UM   PLUS 


Copariaht  <C)  1979»1981 

Iiiaital    EouiPiTipnt    CorHora  t  ion»    rlaynar'lf    Mfj-sSi 

All  Rights  Reserved. 


RSX-1 IS  system  feneration  set-UP  section 

The  sv^stem  devici'  is  the  disk  on  which  all  of  the  host's*  RSX-1  IM-PLlJSr 
system  files  are  stored.  If  your  US  tar<aet  disk  is  the  system  device 
then  there  mavi  possible  be  a  conflict  in  some  file  names  (e.d.K  SY5LIB) 

Is  the  taraet  disk.  DM1 :>  the  system  device?  CY/N]: 
What  is  the  aroup  number  for  the  system  files  CO  R:1-10  IMiT. 
What  is  the  aroup  number  for  the  executive  files  CO  R:1-11  DJlli: 
Copy  the  RSX-llS  distribution  files  to  the  target  disk"!*  CY/N3:Y 
Enter  device  for  the  RSX-llS  distribution  kit  CSi:  DK ; 


Place  the  DISK  labeled  llSKITl  on  DK : 
Is  the  DISK  ready  on  DK:?  CY/N3:Y 


>i 
>» 
>l 
>♦ 

>♦ 
>l 

>> 
.>» 

:>» 
>> 
>» 
>» 
>♦ 
>« 
:>« 
>« 
>« 
:>« 
:>> 
>j 
:>; 
>« 
>Mou  dk:iiskiti 

>PIP  Z2, 200]/NV=DK I C 200 f 2003 1 ISCOPY . CMD 

>UFD  SY:cifn 

>UFD  SY:C1.23 
>UFD  sy:ci»41 

•-UFD  SY;C2»20] 
>UFD  SY:Clf54] 

:>UFD  sy:ci»60d 

>UFD  SY:C1»643 
>UFD  SY:C1»203 
>UFD  SY;C1»24] 
>UFD  SY: CI  1,203 
.>UFD  SY:Cllf24:i 
>UFD  SY:C1»303 

:>UFD  sy:ci,343 

>UPD  SY:Cllf303 

:>UFD  SY:Cllf343 

>UFD  SY:C45»103 

>UFD  SY:C45.203 

>UFD  BY :C 45, 24 3 

:>UFD  SY:C45r301 

>UFD  SY:C45,343 

:>UFD  SY:tllrl03 

■:P1P  Cl,13EXEMC.«f«/DE/NMfEXELIB.0UBJ«,EXEUTL.0DJf«rlJCTDF.0BJ>« 

>PIP  Cl,13DIRSYM,0EiJf»/i:iE/NM,G(;Ml  .  OBJf  «.  ARITH  .OBJf «  ,ODT  .OBJ»« 

>PIP  CI , 1 3LPA . OBJ i «/DE/NM , RSXMAC . SML  i « , FCSRES . MAC  i * 

>PIP  Clf 13PURUDC.0BJt«/DE/NM,PURISA.0BJ{«,PURICR.0BJ»«,LPS.0BJ»« 

>PIP  /FR 


DM1 :  HAS  24207.  BLOCKS  FREE,  919.  BLOCKS  USED  OUT  OF  27126. 
LARGEST  CONTIGUOUS  SPACE  =  10246.  BLOCKS 
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>SET  /UIC-Cl.lJ 

>piF'  ri.i3/NV-riK:ti.i3».* 

>PIP    Clt20a/NV"tiKJCl  f203«.<i 

>PIP    rtf243/NV«DMC1.243«.« 

>PrP    tl.543/NV-DK:Clf54:ilMVHf<.  I  SK 

:>PIP    Clt543/Nk/-DK:C1.54111MTKf(.  rSK 

>PIP    Clf54]HiiVMR.TSK/PU/NM»tlMrMt 

>P I P    C 2 . 200 1 /NV-DK : C  200 » 200 1 « . « . C  2  f  20 3 11 S0EN2 . CHD 

>PIP    C2f203/NV»liKtC2»201«.» 

>PIP    C2r20311SCEN.CMD»«/Dr/NM.llSGEN2.Cmi;« 

>PIP  C45.10]/NV«»DK:C45f  101«.« 

>PIP  C45r20a/NV»=DK:t45.201».« 

>PIP  C45i?41/NV=riK!C4ri.2')J*.« 

>Pip  ciif ioi/nv=iik:cii.ioi».« 
>DMO  dk; 

DM0    -        TTO:  niSMOUNTEIi    FROM    £iKOS  *«»    f'lNAL    HISMOUNr    ««« 

io:i4sio    ***  iiKo:       -  dismount  comfij:te 
>» 

:  »    Rv^lvcp    the    (ii-sk    on    DK :    with    <li&l'     labtfltj><i    ll<>KtT2. 

>> 

>«    Is    the   dist'     rfe.    iw    on    XiK'.f    LY/N3:y 

>MOU    PK;11£!MT2 

>SET    /UlOCltrlO] 

.:PIP    Clltl03/Ny=--rtKSt  11.10]*.* 

>PIP    C  1  f  201*  .  «/PIJ/NM .  r  1  F  :">41*  .  * 

>PIP    C2f201*.«/PlJ/NM.C4r5.10:i«.«.i;45.20D«.*.r4rjF241*.* 

:>pip  /PR 

DMi:  HAS  17257.  Bl  OCK'o  FREE.  V869 .  HLOCKS  USED  OUT  OP  2712A. 
LARGEST  CONTIGUOUS  SPACE  «=  10246.  BLOCKS 

>> 

>i    Distrihijtion   kit    copy    is    riow    coitiF'lete' 

:>> 

>DMO  dk: 

DMO  --  TTO;     DISMOUNTED  FROM  DKO:     **#  FINAL  niSMOUNT  ♦** 

10S42J34   *«*  DKOJ   --  DISMOUNT  COMF'LETL 

>SET  /UIC»C2»200a 

>» 

>i    Bia  disk  distribution  kit 

>» 

>*   3.  Do  Mou  want  to  inhibit  execution  of  MCR  command^''  IY/N1!Y 

>*   5.  Are  you  Meneratind  a  mapped  system?  CY/N3SY 

>♦   7.  Use  an  input  saved  answer  file?  CY/NI* 

>«  10,  Name  of  output  saved  answer  file  CD!  SYSSAVED.CMDl  fS]! 

>» 

>»  Phase  I  output  saved  answers  created  in  file  DM001 S C2.200]SYSSAV;ED.CMDf 1 


Taraet  configuration 

Processor  Type   CD:  11/343   CS3t  11/23 

Does  processor  have  a  switch  reaister?  CY/N3t 
3.  Memory  size  (in  K-word  blocks)  CD  R:1A.-1920.  D:1A.3:  A4. 

Include  support  for  K-series  devices?  CY/N3! 

Floating  point  processor  <FP-11)  present?  CY/NIS 

Extended  instruction  set  (EIS)  present"?  CY/NT? 

Line  freouency:    A-  AO  Hz     B   50  Hz    CD  J  A3  CS3t 

KWll-Y  Uatchdoa  timer  support?  CY/N3S 

Memory  parity  support?  CY/N3SY 
>l 

>l  Th«  response  to  the  following  aucsticn  specifies  the  hiaest  interrupt 
>.■  vector.   If  you  respond  with  a  value  less  than  or  eaual  to  400»  SYi'SEN 
>l  will  assian  the  value  associated  with  the  hiahest  interrupt  vector 
>l  specified  durina  the  Periphertl  Section.   Therefore,  if  your  system 
>J  will  include  devices  that  are  not  specified  durina  the  Peripheral 
>>  Section  and  which  have  vectors  above  400  (devices  such  as  K--series  and 
>l  certain  comiiiunication  devices >f  specify  that  value  in  the  next  auestion. 

:>i 


:>i 

>» 

>i 

>t 

Tar 

>» 

>» 

1. 

>« 

2. 

:>» 

3. 

:>« 

4. 

>« 

6. 

>« 

8. 

>« 

10. 

>* 

11. 

>* 

12. 
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>•    14.    Hi«h*st    int«rriji»t    v»ctor    CO   R:o-774    D!05J 

>l  Tor    d*vic«   corcCKuration!     *•*    Print*    rivvicv    t«hl»r     •.*    T»riftinat««    inou^rw 

>t  •■'•    Prints    cijrr»nt    conf i«iir«tion 

.>!  Enter    d»vic»«    end   m.-nthcr    of    control  l»rs    for    cJ»vic»«    which    rvauir*   driver* 

>•  IS.  D*vic«*  csj:  « 

>» 

>l  D*vir»  code^  for  '4/D  and  i  ndustr  lal/laborator-^  i1evir»«S 

>» 

>t  rtD-    ADOl-D    A/P    Converter 

>#  AF-    AFCn    A/n    Cor.verter 

>f  AR-    ARll    Laboiatorw    Subs^^stem 

>l  IC-    ICRU/ICSll    Industrial    Control    Subs^isteiii 

>♦  IP-    TPtl/IP300    Industrial    Control    Subs-istem 

>f  IS-    IiRSn/nSSll     industrial    Control    Subsvtsteoi 

>•  LA-    LPAll    Laboratory   Subswstem 

>l  LS-    LPSll    Laborator<4   Subswste* 

>l  UD-    IJDAU    Universal    fii^ital    Controller 

>l 

>♦  Device    codes    for    Interprocessor    romHiunicatiori    devices! 

># 

>>  XP-    DAI  t- El    Ititercrocessor    I  ink 

>l  XI.       DL 1  1 -E    InteriTocessor    Link 

>l  XM-    DHCn    E/DMRU     Interr-rocessor    I  inl- 

>|  XP  -    tiPll    Syrii7hronoi)S    Interface 

>>  XQ-     DQll    SyncSrorious    Interfa<  e 

>l  XU-    DUl 1    Synchronous    Interface 

>♦  XW-    DUPll    Swnchrono'js    Intyif-CM 

>♦ 

>f  Device    c-odes    for    unit    record   rfevK-es! 

>» 

>»  CR-    CR11/CM11-P    Card    Reader 

>»  OR-    VTII/VfjiSO    Graphics    Si  ^sH-steni 

>»  LP-    LA180/LP11/LS11/1  Vt I    line    Printer 

>»  PP-    PCU    P.9>-er    TaF-e    Punch 

>l  PR-    PCn/PRll    Paper    Ta^-e    Punch    and    f<fad(?r 

>t 

>>  Device  codes  for  disk  devirpsJ 

:>» 

>l  DB--  RP04/RP0^/RP0A  Disk  Drive 

>l  DP-  TIIS8  Cartridge  DECtaF-e  II 

>|  DF-  RFll  Fi;;ed  Head  Disk  Drive 

>♦  DK   RK0?/RK05  Disk  Drive 

>»  DL-  RL01/R102  Disk  Drive 

>|  DM-  RK06/RK07  Di-sk  Drive 

>»  DP-  RP02/RP03  Dlbk  Drive 

>»  PR-  RM02/RM03/RM05/RM80/RP07  Disk  Drive 

>f  US-  RS03/RS04  Fixed  Head  Disk  Drive 

>»  PT-  TU5A  DECtaF-e 

>|  DU-  UDA50  Unibus  Disk  Adapter 

>»  PX-  RXOl  rioPP«  Pisk  Drive 

>f  DY-  RX02  Floppw  Pi«k 

>»  EM-  MLll  Non-Rot«tin3  Electronic  Memory 

>» 

>>  Device  codes  for  Magnetic  tnipe  devices! 

>» 

>l  CT-  TUAO  Cassette  Tape  Drive 

>♦  MF-  TU78  Magtape  Drive 

>»  MM-  TU16/TU45/TU77/TE1<4  Magtape  Drive 

>»  MS-  TS04  Maatape  Drive 

>»  MT-  TU10/TE10/TS03  Magtape  Drive 

>l 

>i  Device  codes  for  temiinal  interface  devices. 

>l 

>l  YH-  DHll  Aswnchronous  Ter«inal  Interface 

>l  YJ-  PJll  Aswnchronous  Terminal  Interface 

>»  YL-  DL11-A/-B/-C/-P/-E/-J/-W  Asynchronous  Terminal  Interface 

>l  YZ-  DZll  Asynchronous  Terminal  Interface 

>» 
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>» 
>» 
>• 
>» 
>• 
>l 

:>i 
>» 
>i 
>» 
>i 
>« 
>» 
>i 
:>» 
>» 
>» 
>« 
>« 
:>» 
>« 
>« 
>> 
>« 
:>» 
>» 
>> 
>> 
:>» 
» 
>« 
>« 
>« 
>» 
>» 
>« 
>« 
>« 
>« 
>« 
:>« 
:>« 
>• 
>« 
>« 
:>* 
>« 
>« 
>j 
>» 
>» 
:>» 
>» 
:>» 
>t 
>* 
>» 
>» 
>f 
>» 
>f 
>t 
>i 
:>» 
>» 
;>» 


0*vlc»  cod**  for  ^svudo  devices i 

CO-  conmol*  device 
NL-  null  device 

Enter  res^onve*  •*(  devl»nu*ber  control ler«>dev?»nijmher  controllersf  ... 
If  ■  devices  is  specified  without  the  nuMber  of  roritrol  lerst  tht^  nuiiiber 
of  controllers  defaults  to  !• 

ExM^let  DK>DH>2fYLfNL. 

15.  Devices  CSlt  LP>DDtDLf DM> YL»NL . 

Processor: 11/23    HenorM  Size:64Kt Helped    S»steik!RSX-llS 

Host  conf i«uretion 

1.  Is  ■  line  printer  evailebleT  CY/NltY 

2.  Spool  esse»blw  listings  and  Exacutive  and  driver  m8p«''  tY/Ni: 

3.  Does  the  listin«/»ap  device  have  at  least  120  columni'^  [Y/N1:y 

4.  Assemblw  listings  device  <ddut)  CDt  *NL:']  CS]: 

5.  Map  device  for  Executive  and  device  drivers  (dduM  TD:  SYM  CSlt 

EOS  «  Do  vou  want  toS  <CR>-continue  R-rePeat  section  E-estit  P-pause  CS3i 
Executive  Options 

Answer  Y(ES)  if  the  followina  support  is  desired 

6.  Executive  CoMinon?  CY/NJ: 

7.  Hemorw  manaaement  (PLAS)  directives?  CY/N1:Y 

8.  Send/Receive  bw  reference  directives?  CY/N3:Y 

9.  Get  eappina  context  directive?  CY/NltY 
Address  chvckin*  support  will  be  included 
I/O  rundown  support  will  be  included 

15.  Loadable  device  drivers?  CY/N]!Y 

16.  Should  the  default  for  all  applicable  drivers  be  loadable'!'  CY/N3:Y 

17.  Include  support  for  Asynchronous  Sustem  Traps  (AST)''  CY/N3tY 

18.  Include  sup!>ort  for  Cancel  Selective  Marktime?  CY/NISY 

19.  Task  termination  and  device  not  readw  messages  (TKTN)''  TY/N^tY 

20.  Power  fail  recovery?  CY/NltY 

22.  Larae  (20K)  Executive?  CY/N3:Y 

23.  Logical  device  assianment?  CY/N]:y 

25.  Do  «ou  intend  to  include  a  user-written  driver?  CY/N3' 

30.  Executive  Debuaaina  Tool  (XDT)'  CY/N3;y 

32.  Include  support  for  communications  products''  CY/N3S 

33.  S>:<stem  controlled  partitions?  CY/N3:Y 

36.  Group  alobal  event  flaas?  CY/N3:Y 

For  directives! 

*  -  Prints  the  table 

.  -  Terminates  inouiry 

X  -  Gets  all  valid  directives  and  terminates  inauir>4 

37.  Enter  code  for  system  directives  CSIt  * 


A-  Get  partition  par.jmeters 

C-  Send/Receive 

E-  Extend  task 

G-  Get  sense  switch 

I-  Stop  bit 

K-  Parent  offsprina  taskina 


B-    Get    ta<;>    paraihet(?rs 

D-  Alter  priority 

F-  Connect  to  interrupt  vector 

H-  Set  system  time 

J-  Specify  reouested  exit  AST 

I.-  Parent  offsprina  taskina  with  chaining 


Enter  responses  as  codelcode2code3. . .  (no  commas)  (e.a.!  ADCDF . > 
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>«  37.  Entvr  cod*  for  •u<it»*i  dir*ciiv»«  183:  ADD. 

:>•  3B.  NuiKbwr  of  pr»»  aUoiat»rl  010  ftcUmti,    I V    RtO.-lS.  PtS.lI 

:>•  39.  Siz»  of  data  transfpr  v»ctor  in  wordi.  CD  R:0.  33.  D:33.1: 

>«  40.  Round  robin  srhfdulina  interval  ir.  tlt^^i  IV    RtO.  1000.  D!S.]; 

>«  4t.  Hiflhvtt  piiontH  rl«*s  for  con*iderat  lor,  ri"  K!l.-?49.  ritljO.i: 

>•  A2,    Low»<>t  priontw  rla<ift  for  considerat lori  CD  RSt.-t50.  lijl.l! 

>*  4A.  Seconds  b»tw»»n  printer  not  readn  me<>safl»«  fD  ft '.  0 ,  -  J^'iTi .     ri*30.3: 

>»  48.  S««t»tii  crash  reaiiter  and  starl-  dijini"  device  CSR  TO  R:0  177700  rin??";^*!} 

>«  SO.  TwF-e  of  crash  dump  analwsis:   A   PANIC   Ei-  Crash  fiunip  Analysis  (CIiA)  rS1t 

B 

>•  51.  CIiA  output  notification  device  CSR  CO  R :  1 AOOOO- 1 7  7700  Ii:i77riA4i: 

>•  52.  Enter  CDA  memory  duniF-  device  mnemonic  (dduS)  CS  r:J-43:  DLO; 

>•  53.  Enter  CDA  memor-j  dump  device  CSR  CO  R :  160000-177700  D:  17440011 
•>l 

>»  Terminal  driver  o^tionm 
>» 

>•  1.  Terminal  driver  desired  (A/B/C/ti>  «  prints  tahle)  CS3:  $ 
>» 

>l  Terminal  drivers?   A-  Tailorable  half  duplex 

>#  B-  Tailored  half  duplex  (user-oriented) 

>»  C-  rull  duplex 

>l  D-  Baseline  half  duplex 
>» 

>«  1.  Terminal  driver  desired  <A/B/C/ri»  «  prints  table)  CSi:  C 

>•  2.  Unsolicited  input  timeout  value  m  seconds  CD  R:0.-255.  D:120.3S 
>♦ 

>l  Answer  Y<ES)  if  the  folluwina  Hsupport  is  desired 
>» 

>*  6.  Unsolicited  input  character  AST?  CY/N]:Y 

>*  8.  Breakthrouah  write'?  CY/N3:y 

>>  CTRL/'V  support  will  be  included 

:>«  10.  Escape  seouence  handlinS?  CY/N1:Y 

>«  11.  Get  multiple  character istics''  CY/NIJY 

>«  12.  Set  multiple  characteristics'*  CY/NT:y 

>*  13.  Get  terminal  driver  options'*  CY/N3:Y 

>«  17.  Read  after  prompf*  CY/NJJY 

>*  20.  CRT  rubout  supporf?  CY/N3:y 

>*  25.  Hardware  unrecoverable  input  error  notification?  CY/N3SY 

>«  26.  Device  independent  cursor  positioning?  CY/N3SY 
>i 

>*  EOS  *  Do  «ou  want  to!  <CR>-continue  R-repeat  section  E-ewit  P-pause  CS3J 
>» 
>J 

>»  Swstem  Options 
>> 
>» 

>>  Answer  Y<ES)  if  the  following  support  is  desired 
>l 

>«  11.  Uhat  name  would  sjou  like  to  dive  >iOur  s>i<stem  CD:  RSX11S3  CS  R:0-6]:  US 
>i 

>•  EOS  *  Do  Mou  want  to5  <CR>-continue  R-repeat  section  E-e;:it  P-pause  CS3J 
>» 

>♦  Thinkinsl  •  .  • 
>» 

>i  End  of  Executive  option  Seneration  at  10:Si:08  on  03-NOV-81 
>» 

>i  Peripheral  conf iaiuration 
>» 

>>  Parameters   appearing   in   souare   brackets   'C...]'   can   onla  be 

>t  specified   for   the   first   controller   of   a   particular   device. 

>»  Parameters  appearina  in  parentheses  •<...)•  onlvj  need  be  specified 

>i  if    the   indicated   option   i^   present   on   the   tarSet   sastpm. 
>l 

>>  The    default   for   loadable   drivers   has   been   set   to   *TRUE*. 

>♦  To  override  this  settinsi  enter  R  (resident)  as  the  first  r-arameter 

>l  for     the     first     controller    of    the    specified    device. 

:>i 

>t  A/D  and  Laboratory  devices:  None  specified 
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>»    Int«rproc»«sor   coMMurilration   drnvicmmt    Non»   «p»ciri»d 

>l   Unit    record  d*vic*s:    LP 
>» 

>»    Enter    CL/R»]    vectort    CSR»    pnntwr    twf>» 

>»  (fCKMC    timeout    count      O-no   KMC    .    KMC    vector*    KMC   CSR3>    fort 

>» 

>»    1«.    LP   controller    0    CDJ    200r 1775M .LAlBOrOt 300* 1601303    CS3:     r»LVll 

>» 

>t    Dlmkst    DEI*    DLt    [iM 

>l 

>»  Enter  CL/R»3  vector*  CSR*  numher  of  drives  fori 

>» 

>*      3.    DD   controller    0    ClU    .U)0fl7A5001  CRi:     ,  * -> 

:>» 

>•      3.    DL   controller    0    m:    160*1/44001  CSi:    **2 

■>•   53.    Contr    0    unit    0.     is    an   R101/RL02    ID:    RLOll  tSi:    KLO.'' 

:>«   53.    Contr    0    unit    1.     is    ari   RL01/R102    CD:    RLOll  CS3S    RL02 

>» 

>l  Enter  CL/R»3  vector*  CSR*  •  drives.  U*offset  recover«/NO=no  offset  rer.  for: 

:>> 

>»  13.  DM  controller  0  CD:  210.177440**03  CSi;  ..2 

>«  54.  Contr  0  unit  0.  is  an  RK06/RK07  CD:  RK063     CSi:  RK07 

>«  54.  Contr  0  unit  1.  is  an  RK06/RK07  CD:  RK063     CS3:  RK07 

>» 

>>  Tapes:  None  specified 

>f 

>»  Non-Phwsicel  (^seudo)  devices:  CO.  NL*  TI*  CL»  LB*  SY 

>l 

>»  Terminal  interface  devices:  YL 

>l 

>»    Enter   vector*    CSR*    E=DL11-E    modem   suPi»ort/NO=no    for: 

>» 

>«  21.  YL  controller  0  CD:  60* 177560*N03  CS3J 

>t 

>«  EOS  «  Do  «ou  went  to:  <CR>-continue  R-repeat  section  E-exit  P- pause  CS3: 

>l 

>l 

>l  End  of  interrupt  vector  are*  has  been  set  to  400 

>» 

>l 

>l  Create  Executive  build  files 

>» 

>l 

>«   1.  Do  wou  wish  to  edit  an«  of  the  Executive  files?  CY/N3: 
>» 

>i 

>«  EOS  «  Do  wou  want  to:  <CR>-continue  R-repeat  section  E-exit  P-pause  CS3: 

>» 

>l 

>>  Prepare  for  task  building 

>» 

>> 

>>  Clean-up  extraneous  object  files 

>l 

>» 

>«  EOS  »  Do  you  want  to:  <CR>-continue  R-repeat  section  P-pause  CS3: 

>» 

>l 

>»  End  of  IISGEN  phase  I  at  10:56:31  on  03-NOV-ai 

>»      —  To  continue  tape:  eC2*300311S6EN2 

>» 

>»  <EOF> 

> 
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■•IISOEN 

>» 

>l  RSX-llS  Version  4.0  BL32  S^mtfA  Gvnvration  don*  on  RSX-1 IH-F'LUS 

>» 

>l  Co»>Mr»«ht  (C)  1979.1981 

>l  Digital  Eaui^Mvnt  Corporation*  Hawnardf  Ha««. 

:>l  All  Rights  Reserved. 

>» 

>» 

>l  RSX-llS  UK*! em  feneration  aet-u^  section 

:>i 

>>  The  ssst«»ni  device  is*  the  dxsk  on  which  all  of  the  host's?  RSX- 1 1M-PLUS» 

>♦  «wsteBi  files  are  stored.  If  your  IIS  target  disl-  is  the  sustem  device 

■>l  then  there  mas  possible  be  a  conflict  in  some  file  names  <••«.>  SYSLIB). 

>» 

>«  Is  the  tariet  disMr  UMl : .  the  system  deviteT  CY/Ni: 

>«  Uhat  is  the  arouf-  number  for  the  system  files  CO  RM-IO  Dtl3! 

"■*  What  is  the  aroup  number  for  the  executive  files  CO  R:1-11  P:113: 

>«  Co»=.w  the  RSX-llS  <U>,t rjbut ion  files  to  the  target  disk"'  CY/N3: 

■>» 

>»    Bia    di«^    'Iistn  hijtion   ('it 

>» 

>•      3.    fio    ^:lOlJ    warit    to    inhibit    eiiecution   of    MCR   commands?    fY/NJS 

>*      5.    Are    you    aen»»ratina    a    ma^-F-ed    system''    CY/NJSY 

>«      7.    Use    an    ir.put    s.ived    answer    file"?    TY/NltY 

>«      8.    Name    nf    mput    saver)    answer    file    CD:    SYSSAVED.CMD]    CS3: 

>> 

>»  Phase  I  input  saved  nriswers 

>»  crpated  nn  O:^  NOW  81  at  IO:43:iO 

>i    bw  llSGFN  version  l.f;2 

>l    are    from    file    CiMOOl  :  C2.2003SYSSAVrii.CMD>  1 

:>* 

>*    10,  Namp  of  output  saved  answer  file  CD:  DM001 : C2f2003SYSSAVED.CMD3  CS3: 

>f 

>'f    Phase  T  output  saved  answers  created  in  file  DMOOl :  C2»2003SYSSAVED.  CMD»2 

:>f 

>*  11,    IJ&t'    sjved    host    conf I'JurationT    CY/N1:Y 

-*  ir.'.    IJs^?    b<ive>)    peripherdl    conf  isiurat  ion'    CY/N1:y 

>«  rj.    Skip    end   of    section    (EOS)    h  real- point  s'*"    lY/NltY 

>«  14.    Skip    end   of    execution    (EOX)    breakpoints''    LY/N3:y 

>«  15.    riean    up    files    from   previous    GENs?    CY/N15 

>: 

>PIP    /FR 

DM1 :  HAS  17084.  BLOCKS  FREE r  10042.  BLOCKS  USED  OUT  OF  27126. 
LARGEST  CONTIGUOUS  SPACE  =  10246.  PLOCKS 

:>SET  /UIC=C11.103 

>f 

>i    Taraet  conf isuration 

>» 

>;  Processor: 11/23    Memory  Size;64K»Mapped    S«stem:RSX-llS 

>l 

>l  Parity  Memory 

>i 

>>  Host  conf iauration 

>» 

>»  Executive  Options 

>; 

>f  Terminal  driver  options 

>( 

>i    System  Options 

■>} 

>J 

>»      Thinkina  ... 

>» 

>»  End  of  Executive  option  aeneration  at  11 ; 17:49  on  03-N0V-81 

>l 
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>»    P»riph»r»l    conf isumtion 

>• 

>l      Parai»«t»rs   appvarln*   in   sauar*   brackatm   *C>>t3*   can   onlu  ba 

>l      apaclflad   for   tha   first   controllar   of   a   ^articolar   davica* 

>i      Paramaters  ar>i>aarina  in  Faranthaaas  *(...)*  onlu  naad  ba  s^acifiad 

>>      if    tha   indicatad   option   i«   »»ra«ant   on   tha   taraat   sw«ta»> 

>l 

>l      Tha    default   for   loadable   driver*   has   been   set   to   «TRUE«. 

>t  To  override  thia  setting  enter  R  (resident)  a«  tha  firat  parameter 

>|      for    the     first     controller    of    the    sf»eeified   device. 

>» 

>l  A/D  and  Laborator>^  devices*  None  specified 

;>i 

>)    InterFrocesBor  communication  devicesS  None  specified 

:>i 

>t    Unit  record  devices:  LP 

>i  Disks:  nn.  nut  dm 
>» 

>•  Tapes:  None  specified 

>l 

>»  Non-ph«sical  (pseudo)  devices:  C0»  NL.»  TI»  CLi  LB»  S' 

>» 

>l  Terminal  interface  devices:  Yl. 

>» 

>SET  /UIC»Cl»?43  !  Cieatina  TTDRVBID.CMD 

>SET  /UlCoCllflO] 

>>  End  of  interrupt  vector  area    has  been  set  to  400 

:>i 

>i 

>F  Create  Executive  build  files 

>» 

>PIP  RSXMC.HAC-SYJRBXMCO.MAC/AP 

>ASN  sy:=lei: 

>» 

>»  Start  of  EK«»r-.jtive  as'ie'mbly  at    li:2i:04  on  03-N0y-8l 

:>; 

;SET  /UIC=C11»24] 
>MAC  eSY:RSXASM 

>> 

>i    End    of    E;:eriitive    assembly    at    11:3A:24    on   03-N0U-81 

> » 

:•  ;  start  of  device  drivers  assembly  at  11:36:27  on  03 -NOy-81 
>» 

>MAC  eSY:RSXDRVASM 
•>J 
»  End  of  Device  drivers  assembly  at  U:45:39  on  03 -NOV -81 

:>» 

>ASN  =lb: 

>♦ 

>i    Prepare  for  task  buildina 

>t 

>SET  /UIC=C1»243 

>PIP  RSX11S.0B8==C11»24]*.0BJ 

>PIP  TTDRV.0BJ=Cllf243«.TTY 

>LBR  RSX11S/CR:100.:960.:128.=RSX11S.0BS 

:>LBR  TTDRV/CR:30.  :2?56.:A4.=TTDRV 

>PIP  /N>;=rilf  lOlRSXBl.ri.CMD 

>pip  cii.ioirsxbi.d.cmd;«/de/nm 

>f 

>i    Clean-up  extraneous  obJect  files 

>> 

>PIP  RSXllS.0BS(*/DE/NM.TTDRV.0BJJ*fCll»243«.0BJ»«f«.TTYJ« 

>t 

S.  • 


>i    End  of  IISBEN  phase  I  at  11:47:43  on  03-N0V-81 
>»      —  To  continue  tappJ  BC2»200311SGEN2 
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>SET  /UlC»t2t2003 
> 


>*11SGEN3 

>» 

>»  RSX-118  V»r«ion  4.0  BL32  S>4«t*iii  G»n»ration  Phas*  IT 

:>♦ 

>l  Copwriaht    <C)    1975f    1981 

>l  Di!4ltal    Eoijii»m»nt    Corp.-    Maanardf    MA.       01754 

:>t  All    RiMhts   R»s«rv»d. 

>» 

>l       Build  Th»  Executive  And  All  Reauired  Task* 

>» 

>l  This  command  file  will  produce  the  target  swstem  on  Mour  SY>  disk. 

>l  If  it  is  an  RKOS  or  an  RLOlr  this  command  fil«>  will  delete  a  number 

>l  of  files  from  this  disk  to  make  room  for  those  reouired  to  complete 

>i  this  IISGEN.   You  must  be  runnina  on  an  expendable  cop^rf  of 

.'>!  <40ur  dis^.   Note  however?  that  the  disk  will  be  left  in  a 

>t  state  such  that  RSX-llS  swsflens  maw  be  performed  at  a  later 

>l  date.   In  addition?  the  swsnen  itself  maw  be  terminated  and 

>J  maw  be  restarted  at  Just  about  anw  point  to  rebuild  par- 

>»  tirular  Pieces  of  the  swstem. 

>» 

>«  In  what  UIC  is  SGNPARM.CMfi  if  not  r2f2003  CSi: 

>»  Bifl  disk  distribution  kit  IISOEN  version  1.52  for  RSX-llM  BL32 

:>i 

>»  Continuation  from  IISGEN  PHASE  I  done  on  03-N0V-81  at  11:47:39 
>T1M 

ii:3o:o8  o7-Noy-8i 

INS    SY:C1  f54]UMTKB/TASK=.  .  .TKM 

:>ASN  sy:=lh: 

>t 

>t    Expanded  comments  provide  a  complete  description  of  every  step  in 

>i    this  IISGEN  command  file.   On  the  other  hand?  short  comments 

>>  provide  virtually  no  explanatory  text. 

>> 

>*  Do  wou  want  expanded  comments''  [Y/N3;Y 

>» 

>J  Create  RSX-llS  subset  swstem  library 

>»  if  you  have  not  already  done  so. 

>» 

>SET  /UIC"Cl»n 

>«  Have  you  already  created  1  ISLIB.OLB'?  CY/Ni: 

>LPR  LB:11SLIB/CR:30. :896. :320. 

>*  Have  you  already  Puilt  the  Exec?  CY/Ni: 

>SET  /UIC=C1»243 

>» 

>t    Pi.irae   Exec    build    command    files    and    assembly    prefi;-!    files 

>; 

>PIP  RSXBLD.CMH/PU/NM 

>PIP  ril»103RSXMC.MAC/PU/NM 

>i 

>t    Now  we  build  the  Executive 

>i    If  yoij  must  make  chaniSes  to  the  Executive  build  files 

>*  answer  yes  to  the  followina  ouestion.  Edit  RSXEiLD.CMD 

>J  by  issuina  the  command  EDI  LFi:R!iXBLD.C:MD.  11SGEN2  will 

>t    build  the  Executive  after  you  resume  from  the  pause. 

>» 

>«  Do  you  wish  to  edit  the  Executive  build  file?  CY/Ni: 

>TKM  (?i.b:rsxbld 

>«  Did  the  Executivp  build  successfully?  CY/N3:Y 

>SET  /UIC=C1.A4: 

>*  Do  you  want  to  build  any  loadable  drivers  now?  CY/N3:Y 

>» 
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>>    Build  Loadcbl*  dnvarv 

>«       3.     rifvicp    for    rirwer    ",    mf,^-i    r  Ti :    Nl   i^    1ST,    Srt 

>SFT  /uir=ri.?4i 
>l 

'•J    Th»    follnwiri'*    are    nirif>niori irs    r:f    thf    Inadahle    d*vic»   drivers    si>l«>ct.»rl. 

:>f     nn    ru     pm    i  p 
>» 

>»  Uh*n  all  drivers  are  bijilt.f  st^l^f■  rarnasip  rpturn. 
>» 

>«   5.  Driver  2"Ch«racter  devire  wneitioriir  rF>/5  DP 
>«   i.  Drive  partition  name  tDt  DRV/PAR 1  CSIJ 
>TKM  (JSYSDDDRyBLD 

>•   b.  Driver  ?  character  device  mnemonic  CSIS  PL 
>«   6.  Drive  partition  r.ame  CD:  DRVFARJ  tSlt 
>TKM  BSYIPLPRWBI.D 

>•   5.  Driver  2-character  device  mnemonic  CSJ!  DM 
>*   6.  Drive  partition  name  TDt  PRVPAR3  CS3: 
>TKH  PSYtDMDRVBLD 

>•   5.  Driver  2-character  device  mnemonic  rS3'  LP 
>«   6.  Drive  partition  name  CD:  DRVPAR3  CS]: 
>ThM  eSY:LPDRVBLD 

>•   5.  Driver  2-ch8racter  device  nnemonic  CSi: 
>SET  /UIC=LlfA43 
>SET  /UIC=:if241 
^( 

>i    You  now  need  the  Executive  map  to  la>40i.jt 
>i    the  partition*  in  your  new  system. 
>« 

>*  Do  sou  have  the  map  already?  CY/N3J 
>PIP  Cl»343RSyilS.MAP/SP 
>» 

.•  r  Look  in  the  map  of  the  Exuc  for  the  symbol  "♦SYTOP*  which 
>»  indicates  the  last  address  allocated  to  the  Exec.   User 
>»  partitions  may  start  at  any  location  beyond  this  address 
>»  as  Icna  as  they  fall  on  a  64  byte  boundary.  See  the  RSX-llM 
>»  Sysden  manual  for  a  description  of  how  to  set  up  partitions. 
>t  You  may  wish  to  stop  at  this  time  to  layout  your  partitions. 
>i 
>*  Have  you  already  built  the  full  duplex  terminal  driver?  CY/N3' 

>; 

>i    Now  we  build  the  full  duplex  terminial  driver 

>i 

>f 

>(    The   task  build  command  file  for  the  full  duple   terminal  drive 

>t    specifies  that  it  run  iii  partition  TTPAR»  havinJ  a  length  of 

>»  40000  octal. 

>  r 

>*  Do  you  wish  to  edit  the  build  command  file  for  the  terminal  driver''  CY/ND: 

>TKM  BLB: TTPRVBLD.CMD 

>«  Did  the  terminal  driver  build  successfully?  CY/N3JY 

>*  List  full  duplex  terminal  driver  map?  CY/N3: 

>•  Do  you  want  to  continue  and  build  the  privileged  tasks?  CY/N3:Y 

>i 

>i    Prepare  to  assemble  and  build  the  RSX-llS  privile<led 

>t    software  components. 

>» 

>}  The  tasks  TKTNr  BASMCRf  OTL>  and  SIP  must  be  assembled*  and  the 

>f  task  build  command  files  possibly  edited  before  they  can  be  built. 

:>>  The  tasks  RSDV05»  RSDV52»  and  RSDVIH  need  only  to  be  builtr  but 

>i    their  command  files  may  also  be  edited  before  they  are  built. 

>i    It  is  not  necessary  to  save/print  the  assembly  listings? 

>i    However*  we  recommend  that  you  save/print  the  task  build 

>f    maps.   This  is  especially  important  when  generating 

>»  an  unmapped  system  --  k'ithout  maps  it  will  be  difficult 

>>  to  determine  partition  limits. 

>; 
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>«    A«<i»iiihlH    list    liftvxcB    for    F.iv>lt»4*d    tavk*    (DDNNI)    ZVt    NL  H    CSli 
>t    M»^    f1»vire    frr    cr  i  vi  Iw-lBd    l««t«s    <DPNN:)     CD!    SY  n    CS3J 
>»   Hav*    wou    Jlr»ar)><    duilt    ta«W    TKTNi*    TY/N]! 
>l 

T»ml'    TKTN   will    be    includwd    In    wour    119    svstvm    as    a    rosult 

of    vour    s*l*rtion    in    IISOEN   Pha«i>    T. 


> 


Th«  privi  l#«i»<1  Ih-sI's  FiASMCK.  Orif  and  SIP  were  "iperlallw  desiSned 
for  use  in  the  Rf>X-llS  environment.   Their  inrlusinn  in  the  ssstem 
is  oi'linnal.   If  desipedr  thew  will  he  assemhled  and  huilt  under 
cofptrol  of  this  command  file. 

Do  >^c|l|  wi<ih  tn  inrlndr  BASMChr  (1TI  .  or  SIP  in  Hour  •iHstem'  CY/N]:Y 

The  t.a^Mr,  RSTiVOSt  PSnvriJf  .»nd  F<SnviH  dsnamicallw  diselaw  the 
the  status  of  niemors*  on  a  ira^-hirs  terminal  and  ran  he  huilt 
for  the  UT05H  tennnalr  WTfi?  terminal*  ano  VTIOO  terminal 
resPHct  1  vely .   The«ie  tasks  disr-las  whirh  tasks  are  in  memor>j 
and  where  in  memorw  thew  reside*  whirh  task  la  currentls 
runntri«l»  »nd  the  status  of  pool. 

to    <JOii  want  1o  inrludf  RKHVOrj*  RSPUS?*  or  RSDVIH''  rY/N3JY 

T^)e  RSX-llS  suhset  file  control  services  (PCS)  are  dist- 
rihuted  as  a    sin<ile  file  containing!  the  concatenated  obJert 
modules.   They  cannot  be  placed  in  the  RSX~11M  system  object 
librars  (SYSLIB.OLB) .   However*  users  who  reauire  this  PCS 
should  link,  with  the  RSX-llS  subset  of  SYSl.IB  (IISIIB.OLB) 
crested  dijrin«l  this  Sws<ien> 

Do  sou  wish  to  include  the  RSX-llS  subset  PCS''  CY/N3:Y 

The  RSX-llM  crash  dump  analazer  (CHA) 
mas  also  be  built  to  run  on  a  non-M 
host  system  for  analysis  of  RSX-K.-i 
crash  dumes. 


>•  Do  «ou  wish  to  build  CDA  for  your  host  system''  CY/NJtY 

>SET  /UIC=CllrlO] 

>UFD  SY:C11.103 

UFD  —  DIRECTORY  ALREADY  EXISTS 

>*  Do  «ou  wish  to  make  corrections  to  RSX-llS  source  modules?  rY/N3J 

>SET  /UIC=C1»243 

>MAC  OTKNASM 

>PIP  TKNASM,CHD»«/DE 

>» 

>»  The  task  build  command  file  for  TKTN  specifies  that  it  run  in 

>»  partition  SYSPAR*  havina  a  length  of  3700  octal. 

>i    If  you  must  chanae  the  partition  name  or  length f 

:>»  wou  will  have  to  edit  its  task  build  command  file. 

>» 

>«  Do  you  have  to  edit  the  task  build  command  file  for  TKTN?  CY/N3J 

:>TKM  BTKN11SBLD.CMD 

>f 

>i    BASMCR  is  a  erivllesed  task  which  supplies  a  subset  (or  basic 

:>»  set)  of  th»  RSX-llM  MCR  commands.  It  can  not  be  included  if 

>l  durina  Sysaen  Phase  I  you  indicated  that  you  did  not  want  any 

>»  terminal  devices*   Its  size*  depending  upon  options*  ranaes 

>l  from  6400  to  14000  octal  on  mapped  systems. 

>» 
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>•  Do  wou  want  to  Includ*  task  BASMCRT  CY/NltY 

>UFD  SYtC16tl03 

>UFD  SYtC14t243 

>9ET  /UIC*C16flO] 

>PIP   BMPRE.HAC>«/DE/NI! 

>PIP   «.MACI«/RM/NH 

>PIP    C16>«3«.«I«/DE/NM 

>PIP  C16f 10]-C2»20]BMPRE.MAC 

>PIP  C16f 103/EN-C2r203AB0BA8.MAC>ATLBAS»BRKBASfERRBAS>ERRMB0 

>PIP  C16f 103/EN-C2r20]FMTDV.HAC»FNDUCB»ONBLK»OEfNUH»KEYWD 

>PIP  C16f 103/EN-C2f20]LKL8T.HAC»MCRBA8»0PEEiAS>PRSBAS>REDBA8 

>PIP  C16>103/CN-C2>203REHBA8.MACfRPSBAStRUNBASfTTHBAS 

>8ET  /UIC-C16f243 

>• 


Tha  siza  of  BASIC  HCR  i«  da^andant  u^on  tha  inclusion  of 
conditional  assaMblw  coda>   Tha  inclusion  of  tha  coda  is 
control  lad  bw  awmbol  dafinltions  a^paarina  in  an  aasamblw 
prafix  fila>   Tha  dafault  for  thasa  conditionals  is 
axcl(jsion>   Tha  following  optionsr  alona  with  tha  corras- 
pondlna  control  swmbolsi  ara  avallablat 


R»*ATL 
RttERM 
R»«OPE 

To  includa 
and  ramova 
axampleS 


>» 

:>» 
>» 
:>» 
:>i 
>» 
>» 
>f 
>l 
>♦ 
>» 

>»  To  includa  an 

>l  and  ramova  thi 

>» 

>l 

>l 

>l 

>» 

>» 

>» 

>l 

>>  Rapaat 

>>  appaar 

;>» 

>*  Do  uou  wish  to  adit 

>Eni  C16f 103BMPRE.MAC 

C00029  I INES  READ  IN3 

CPAOE     13 

«PL  »R»*ATL 

»R»»ATL  »        0 

«C  /»// 

R«»ATL   =        0 

« 

»R*»ERM  =■        0 

«C  /»// 

R»»ERM   =        0 

« 

»R»»OPE  =        0 

«C  /»// 

RttOPE   =        0 

«EDX 

CEXIT3 


ATL/TAL  COHHANDS 
ERROR  MESSAGE  TEXT 
OPEN  COMMAND 


option  locata 
saikicolon  at 


«PL  »R»»ATL 
»R«»ATL  =  0 
«C  /»// 
R»»ATL  =  0 

« 


this  for  all  dasirad 
on  consecutlva  Unas 


the  dasirad  conditional  swmbol 
tha  badlnnin*  of  the  line.   For 


♦INCLUDE  ATL 


» INCLUDE  ATL 


options  I   Note  that  tha  s>:<Abols 
in  alphabetical  order  in  the  file. 


tha  assambltrf  prefix  file  for  BASMCR?  [Y/N3$Y 


>  INCLUDE  ATL 


f    INCLUDE  ATL 


i    INCLUDE  ERROR  MESSAGES 


»  INCLUDE  ERROR  MESSAGES 


»  INCLUDE  OPEN 


I  INCLUDE  OPEN 


>MAC  eBASMCRASM.CMD 

:>SET  /UIC=«Ci»243 

>PIP  ClA»103BMPRE.MACf*/DE/NM 

>PIP  C1A»103«.MACJ«/RM/NM 

>PIP  BASMCR. 0BJ=C1A»243«. OBJ 

>PIP  ClA.243«.*f*/DE/NM 

>LBR  BASMCR/CR : 21 . 1 64 . : 64 . =BASMCR 

>PIP  BASMCR.OBJ»*/DE/NM 

>» 
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>l  Th»  t««K  build  coikmancj  film   for  BASMCR  m^vciflvs  th«t  it 

:>»  run  in  partition  MCRPAR»  Iwnflth  14000  ortal  (mappvd). 

>>  If  wou  i»umt  ch«n«*  th»  partition  nam*  or  lan4th> 

>l  wou  Hill  hav*  to  edit  it<i  task  build  command  fil*t 

>♦ 

>*  Do  wou  wiah  to  adit  tha  ta«k  build  command  fila  for  PAflMCR''  tY/NIt 

:>TKM  »BA8MCRBLD.ChD 

>» 

>l  OTL  i«  a  prlvllaflad  task  which  in  tha  R8X-11S  on-lin»  task  loadar. 

>>  it  parforms  tha  install*  load*  and  fix  functions  for  tasks  which 

>l  wara  craatad  on  a  host  dava^opmant  s^stam  and  copiad  via  FL^<  to  a 

>l  load  madium.   Dapandinfl  on  'tha  number  of  load  davicas*  ate?  OTL 

>l  ran«as  from  8000  to  15000  octal  on  mappad  swstams. 

:>i 

>«  Do  wou  want  to  includa  task  nXL?  CY/N3:Y 
:>UFD  SYJC20»10D 
>UFD  SY:C20»243 
>SE:T  /UIC-C20f103 

>FiP  sy:otlpre.mac»»/de/nm 

:>PIP  SYJ*.MAC»«/RM/NM 

>PIP  C20»«3«.«>«/DE:/NM 

>PIP  C20rl03-C2f203OTLPRE.HAC 

•PIP  C20.103/EN-C2»2030TL.MACtOTLCDfOTLCM»OTLERR 
>PIP  C20>10]/EN>C2>20]0TLHD.MACr0TLLBf0TLLD>0TLQI0f0TLRD 

>SET  /UIC-C20»24] 

:>i 

''■t  The  size  of  OTL  is  dependant  upon  the  inclusion  of  conditional 

>t  assemblw  codet   The  inclusion  of  the  code  is  done  in  two  wa»s> 

>)  bw  a  sinale  symbol  definition  and  b<i<  macro  calls  appearing 

>l  in  an  assemblw  prefix  file.   The  first  controls  the  inclusion 

>i  of  error  message  text.  To  include  this  optionr  locate  the 

>l  sumbol  Rf^ERMo  and  remove  the  semicolon  from  the  beslinnind 

>>  of  the  line.   The  default  for  error  message  text  is  exclusion. 

>l  For  example t 

>l 

>l       *PL  SR**ERM 

>»       IR*»ERM=0 

>l       «C  />// 

>t  R»»ERM-0 

>» 

>>  The  other  tape  of  option  concerns  the  exclusion  of  unwanted 

>i  device  support.   For  each  of  the  OTL  load  devices  which 

>t  were  included  in  Swsden  Phase  Ir  corresponding  support  will  be 

>(  Generated  in  OTL.   Naturallwf  support  will  not  be  generated  for 

>l  those  OTL  load  devices  which  were  not  included  in  Susaen  Phase  I. 

>>  The  following  devices  along  with  corresponding  control  symbols 

>l  mav<  be  supported  b>j  OTL. 

>; 

>»       PRll  -  PAPER  TAPE  READER 

>l       RXll  -  RXll  FLEXIBLE  DISK 

>»       RX21  -  RX211  FLEXIBLE  DISK 

>»       TAil  -  CASSETTE  TAPE 

>»       TCll  -  DECTAPE 

>»       TMll  -  TM/TMA/TMBll  HAGTAPE 

>»       TSll  -  TS04  MAGTAPE 

>»       TU16  -  TJ/TUU16-45  MAGTAPE 

>f       TU58  -  TU58  CARTRIGE 

>♦ 

>»  To  exclude  OTL  support  for  a  device  which  has  been  generated  into 

>}  your  RSX-llS  Executive?  locate  the  corresponding  device  symbol 

>}  and  Place  a  semicolon  at  the  beginning  of  the  line.   For  example] 

>l 

>»      *PL  PRll 

>»  INCLUD   PRll»Pt$Rll      fPCll/PRll  SUPPORT 

>»       «C  //»/ 

>»       I        INCLUD   PR11»P««R11      JPCll/PRll  SUPPPRT 

>)       * 


>» 
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>l  P«rfor«  this  for  all  of  th«  above  d*vlc««  which  will  b*  ^art  of 

>^   wour  R8X-11S  Exvcutiw*  but  for  yhich  wou  do  not  want  OTL 

>l  suF^ortt   Not*  that  tha  awmbols  a^i>aar  on  consacutiva  linaa  In 

>l  al^habatical  ordar  in  tha  flla. 

>l 

>«  Do  wou  wish  to  adit  tha  asaaNiblw  prafin  fila  for  OTLT  CY/N3IY 

>ED1  C20tl030TLPRE.MAC 

COOOAO  LINES  READ  IN3 

CPA6E     03 

»PL  >R««ERM 

C00060  LINES  READ  IN] 

IR««ERM->0 

»C  /»// 

R«»ERM-0 

«EDX 

CEXIT3 

>HAC  tOTLASH.CHD 

>SET  /UIC-Clf24] 

>PIP  C20fl030TLPRE.MACI*/DE/NM 

>PIP  C20»10]«.HAC»«/RH/NN 

>PIP  0TL.OBJ-C2Of24]«.0BJ 

>PIP  C20»24]«.«I«/DE/NM 

>LBR  0TL/CRt21.tl28.}64.-0TL 

>LBR  0TL-C2f203BLXI0H 

>PIP  OTL.OBJ»«/DE/NH 

>» 

>>  Tha  ta*k  build  coitaland  fila  for  OTL  a^acifiaa  that  it 

>l  run  in  i»artition  OTLPAR?  lan«th  ISOOO  octal  (aaf^pad). 

>l  If  wou  auat  chanaa  tha  partition  na»a  or  lantfthr 

>l  wou  will  hava  to  adit  its  tasK  build  coMisand  fila. 

:>» 

>«  Do  wou  wish  to  adit  tha  task  build  comiiand  fila  for  OTL?  CY/N]t 

>TKM  90TLBLD.CMD 

>f 

>>  SIP  is  a  privila«ad  task  which  parforas  tha  R8X-118  swstam 

>t    iaa«a  prasarvation  dutias.   It  raplacas  tha  RSX-llH  SAV  MCR 

>l  coaaiandt   Dapandina  on  tha  nunbr-  of  load  davicasr  atcr  SIP 

>l  ranMas  fro*  3700  to  7400  octal  on  aappad  swstaiiis> 

>» 

>«  Do  wou  want  to  includa  task  SIP7  CY/N3:Y 

>UFD  SYtC21fl0] 

>UFD  SYtC21»24] 

>8ET  /UIC-C21rl03 

>PIP  8Y:8IPPRE.MACI«/DE/NH 

>PIP  8Y»*.MACI«/RM/NH 

>PIP  C21f«]*.«(«/DE/NN 

>PIP  C21»10D-C2»203SIPPRE.HAC 

>PIP  C21»103/EN-C2»203SIP.HAC.SIPB00,SIPCD»SIPERR 

>PIP  C21 » 103/EN-C2.203SIPLD.HAC»SIPQI0 

>8ET  /UIC«C21f243 

>» 

>l  Tha  siza  of  SIP  is  dapandant  upon  conditional  assaablw  coda 

>t  in  anactlw  tha  sai»a  mannar  as  OTL>   Thara  ara  onlw  a  faw  ainor 

>l  diffarancast   OTL  supports  tha  papar  tapa  raadar  usina  th« 

>>  control  swabol  PRll)   SIP  on  tha  othar  hand  supports  tha  papar 

>l  tapa  punch  usin*  tha  control  swabol  PP11«  In  addition*  OTL 

>l  supports  DECtapa  II  cartriaas  usina  control  swabol  TU58  and 

>l  T811  aaSnatic  tapa  drives  usina  tha  control  swabol  TSllt 

>l 
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>«   Do  wou   wish   to   edit   th«   ■asviiiblw   i>r«fl><   film   for   8IPT    CY/NltY 

>EDX    C21>10]8IPPRE.MAC 

C00060  LINES   READ    IN3 

CPAOE  03 

»PL    IR««ERM 

IRttERH-O 

«C   /»// 

R««ERH-0 

»EDX 

CEXIT3 

>MAC  9SIPASM.CMD 

>SET  /UIC=C 1.243 

>PIP  C21.10]SIPPRF.MAC»«/riE/NM 

>PIP  C21»101«.HAC»«/RM/NM 

::PIP  SIP.0BJ=»C21»241«.0BJ 

>P1P  C21.243*.«f«/DE/NM 

>LBR  SIP/CR:20.:A4. :64.=SIP 

>PIP  SIP.OBJ»*/DE/NM 

:>» 

>»  Tib   task  build  command  file  for  BtP  sppcifius  that  it 

:>»  run  in  partition  SIPPARf  lenilth  7400  octal  (mapped). 

>>  If  wou  must  chande  the  partition  name  or  len«jthF 

>»  «ou  will  havB  to  edit  its  task  build  command  file, 

:>i 

>«  Do  «ou  wish  to  edit  the  task  build  command  file  for  SIP?  CY/NDt 

>TKM  (JSIPBLD.CMD 

>SET  /UIC=«C1»243 

:>PIP  RMD.0LB/NV=C2»203RMDHAP.0LB 

;>«  Do  aou  want  to  include  task  RSDV05?  CY/N3: 

>«  Do  Mou  want  to  include  task  RSDV52?  CY/N3: 

>«  Do  wou  want  to  include  task  RSDVIH?  CY/N3JY 

>» 

>l  The  task  build  command  file  for  RSDVIH  specifies  that  it 

:>»  run  in  partition  RSDVlHf  lenath  40000  (octal). 

>>  If  uou  must  chanale  the  partition  name  or  leniathr  >jou 

>»  will  have  to  edit  the  task  build  command  file. 

>l 

>*  Do  «ou  wish  to  edit  the  task  build  command  file  for  RSDV?H?  CY/ND: 

:>TKM  BRSDVIHBLD.CMD 

>SET  /UIC=C1»24] 

>» 

>r  It  maw  be  necessary  to  edit  the  task  build  command  file  and  ODL  file 

>»  to  build  CDA  for  the  non-M  host.   Chanse  the  partition  name  and 

>>  base  address  to  match  that  of  the  partition  (on  the  host  swstem)  into 

:>>  which  CDA  will  be  installed.  You  will  also  need  to  change  the  ODL 

>J  file  to  reference  the  correct  device  on  the  host  where  SYSLIB  and 

>)  EXELIB  reside.   The  files  are  named  CDABLD.CMD  and  COABLD.ODL. 

>(  Ue  will  now  pause  to  allow  uou  to  edit  the  command  files. 

AT.  ~  PAUSING.  TO  CONTINUE  TYPE  "UNS  AT. TO  • 

> 
> 
> 

> 

>UNS  AT. TO 
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AT.  —  CONTINUINO 

> 

>8ET  /UIC-Clf64] 

>TKM  «C1>34]CDABLD 

>l  Th*  CDA.T8K  fil»  r*sid««  in  Clr64]  on  wour  RSX-llS  «w««*n  diwk 

>l  and  can  b*  run  on  th«  ho«t  mw«t*iii. 

>8ET  /UlC-r  .243 

>» 

>l  Add  subset  FCS  to  th»  RSX-llS  swstan  obJvct  llbrarw 

>• 

>8ET  /UIC-C1>13 

>LBft  LBtllSLIIl/RP-C2>20]FCSllS 

>PIP  LBJllSLIB.OLB/PU/NM 

8Fr  /UIt>CtrA41 
>PIF-  ».«/PU/NM 
>PIP  C1»243«.«/PU/NM 
>l 

>l  Th*  OF«ration  Imft   to  b»  p«rforA«d  is  that  of  th*  final 
>l  configuration  of  th*  virgin  aKacutiv*  usina  Virtual  MCR. 
>» 

>*  Do  wou  want  to  confi«iura  the  Exec  at  this  time  usind  VMR?  CY/N3JY 
>» 

>l  Tha  contents  of  siour  RSX-ltS  release  kit  currently  resides 
:>»  under  the  UFD  C2.:?01.   If  «our  SYt  disk  is  not  an  Rh06/07  or  an 
:>»  RP04/05/06  you  may  want  to  delete  these  files.   Leavins 
>•  them  on  the  disK  will  save  the  time  of  re -copying  thei*  the  next 
>>  tidie  ^ou  perform  an  RSX-llS  Sysaen.   If  your  SY*  disk  is  an  RK05» 
'>^    they  will  be  automatically  deleted. 
>» 

>«  Do  you  war.t  to  delete  thp  RSX-llS  kit  from  this  disk?  CY/N]: 
>( 

»  Up  will  now  make  .i    copy  of  your  tar«iet  system 
>» 

:>PIP  RSXUS  .SYS/NV/nO/BL  i  258 .  =RSX1  IS .  TSK 
.>! 

>>  If  you  wish  to  make  a    copy  of  your  task  or  system  imaae  file 
>l  on  another  device  we  will  pause  now  to  allow  you  to  do  so. 
>» 

>*  Do  you  wish  to  copy  your  system  to  another  device?  CY/N]* 
>> 

>t    RSXllS.TSK  is  a  backup  copy  of  the  118  system  you  have  Just  built. 
>>  If  you  do  not  wish  to  retain  it>  we  will  delete  it  now. 

:>» 

>«  Do  you  wish  to  delete  the  system  backup  file  RSXllS.TSK?  CY/Ni: 

>» 

X    Your  tarSet  system  is  now  ready  to  set  up  partitions  and  install 

>t    the  reouired  tusks.   The  procedure  to  follow  isS 

>»       1>  Run  Virtual  MCR 

>•       2)  Extend  POOL  seace  to  base  of  first  partition 

>l      3>  Set  UP  wour  partitions 

>l      3B)  Load  needed  drivers 

>i       4)  Install  tasks  (BASMCR.  OTLr  SIPr  TKTN) 

>l      5)  Fix  tasks  into  (virtual)  memory 

>f       6^  Iptionally  set  the  time  and  save  a  copy  of  THE 

>l         ■ wstem  on  a  bootable  medium 

>♦       '' •  exit  from  virtual  MCR  and  boot  in  your  target  system 


9 


>l 
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VMR  •xsAPl*; 


• 


>yHR  !  RUN  VIRTUAL  MCR 

ENTER  FILENAHE:RSXnS.SYS   !  VMR  '•ROMPTS  FOR  FILE  NAME 

VMR>SET  /RDOL-XXX         "  EXTEND  POOL  TO  FIRST  PARTITION 

/main-ttpar: XXX : XXX ; TASK  iset  up  full  duplex  tt 


VHR'SET 
WHR>SET 
VMR>SET 
WMR>SET 
VHR>SET 
VMR  SET 
VMR>SET 
VHR>SET 
VMR>SET 
VMR>LOA 
VHRMNS 
VMR>FIX 
yMR>INS 
VMR>FIX 
WMR>INS 


/MAIN- 
/MAIN' 
/MAIN- 
/MAIN- 
/MAIN^ 


DRVPAR : XXX : yxx : task 
SYSPAR ! XXX : XXX : task 
MCRPAR : XXX : XXX : task 
otlpar: XXX : XXX : TASK 
s IPPAR : XXX : XXX : task 


/MAIN=RSDV1H: XXX : XXX S TASK 
/MAIN-GEN?XXX:XXX:SYS   •  IF 

/main-gen: XXX : XXX : TASK  •  if 


wmr:: 
vmr: 
vmr: 

VMR- 


FIX 
INS 
FIX 
INS 


VMR>FIX 
VMR>TIM 
VMR>SAV 
VMR>"Z 


xx: 

TKN 

TKTN 

B/'SMCR 

nCR  * •  • 

OTL 

OTL 

SIP 

SIP 

RSDVIH 

RSDVIH 

10:4"5  11/10/77 

DXtRSXllS 


End  of  VMR  my.mmwl9 


>» 
•I 
^t 
>l 
>t 
>» 
>l 
>l 
>t 
>» 
>» 
>f 
>l 
>» 
>l 
>♦ 
>f 
>l 
>f 
>» 
>» 
>» 
>» 
>l 
>» 
>» 
» 
>» 
>l 
>l 
>» 
>l 
>» 
>» 
>» 
>» 

:>» 
>» 
>♦ 
:>» 
:>» 
>j 
>» 
>i 
>i 
>» 

>INS  SY:C1»54D11MVMR/TASK 

>VMM 

Enter  filename:  RSXllS 

vmr>set  /pool=450 

/main=ttpar ! « : 400 : task 

tt; 

/main-drvpar  '.*'.*'.  sys 

dd: 

dl: 

dm: 

LPJ 

/top=drvpar:-* 

VHR    —   «DIAG«-In6talled   tasks   mavi 

VMR>SET  /main=syspar:«:37:task 
/main-mcrpar : » : 1 40 : task 
/main«otlpar:«:i5o:task 
/MAIN'SIPPAR : « : 74 : task 

/MA I ^"RSDVl H : « : 400 ; TASK 

/mai.<<'GEn:*:«:sys 

TKN 

TKTN 

BASMCR 


BASE 
PARTITION 


1  SET 

UP 

1  SET 

UP 

!  SET 

UP 

1  SET 

UP 

1  SET 

UP 

SET 

DRIVE'<  PARTITION 
TKTN  "PARTITION 
MCR  FART  IT  ION 
OTL  PARTITION 
SIP  PARTITION 
UP  RSDVIH  PAR 


SYSTEM  CONTROLLED  PAR. 
USER  CONTROLLED  PARTITION 

LOAD  XXDRV 

INSTALL  TASK  TERMINATION  TASK 

FIX  INTO  MEMORY 

INSTALL  BASIC  MCR 

FIX  INTO  MEMORY 

INSTALL  ONLINE  TASK  LOADER 

FIX  INTO  MEMORY 

INSTALL  SYSTEM  PRESERVATION  TASK 
I  KIX  INTO  MEMORY 
'INSTALL  R3DV1H 
!FIX  INTO  MEMORY 

SET  TIME  AND  DATE 

SAVE  SYSTEM  ON  RXOl  FLOPPY 

EXIT  FROM  VIRTUAL  MCR 


Now 
Mour 


we  will 

sviste*. 


at  this  tine*  because 
in  RSX-IAS  BASIC  MCR. 


run  Virtual  MCR  so  that 
Be  sure  to  define  all 

the  SET  function 
Furthermore?  if 


>:«ou  ma>:j  initializ(> 
reouired  partitions 

is  not  supported 

you  plan  to 


include  BASIC  MCR  and  OTL  in  your  system*  they  must 
be  installed  and  fixed  into  memory.   Other  tasksr 
such  as  SIP  and  TKTN  may  be  loaded  into  a  runnina 
RSX-llS  system  usin^  OTL. 

note:  Since  LOAD  and  UNLOAD  are  not  supported  on 
a  running  RSX-llS  system?  all  reauired  loadable 
drivers  must  be  loaded  usina  VMR. 


.VMM 


VMR>SET 
VMR>LOA 
VMR>SET 
VMR>LOA 
VMR>LOA 
VMR>LOA 
VMR>LOA 
VMR>SET 


no  longer  fit  in  partition 


VMR>SET 
VMR>SET 
VMR>SET 
VMR>SET 
VMR>SET 
VMR>INS 
VMR>FIX 
VMR>INS 
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VMR>FIX 
VMR>IN8 
VHR>F1X 
VHR>IN8 
WHR>F1X 
VMR>INS 
WMR>FIX 

yrtR> 

VMR>PAR 

TTPAR 

DRyPAR 


MCR  t • • 

OTL 

OTL 

SIP 

SIP 

KSDUIK 

R8DV1H 


SYSPAR 

MCRPAR 

QTLPAR 

SIPPAR 

R8DV1H 

OEN 

VMR>TAS 

TKTN 

RSDVIH 

NCR » *  * 

OTL 

SIP 

yMR>DEV 

LPOJ 

DDO: 

DDlt 

DLOJ 

DLi: 

DHO: 

DMi: 

TTOJ 
NLO: 

Tio: 
coo: 

CLOt 
IBOt 

SYo: 


044734 
044600 
044S34 
044400 
044300 
044200 
044100 
044034 
043770 
043724 
043660 
043614 


04.7 
VI. 05 
3.1 
02 
02.5 


04S000 
105000 
105000 
107400 
111000 
113400 
114500 
120400 
134400 
151400 
161000 
221000 

043510 
042134 
043220 
042730 
042430 


LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 


040000 
007500 
002*00 
001400 
002400 
001100 
00J700 
014000 
015000 
007400 
040000 
157000 


MAIN  TASK 
MAIN  SYS 


SUB 
SUB 
3UD 
SUB 


DRIVER 
DRIVER 
DRIVER 
DRIVER 


DDi 

dl: 

DMi 

lp: 


MAIN  TASK 
MAIN  TASK 
MAIN  TASK 
MAIN  TASK 
MAIN  TASK 
MAIN  SYS 


SYSPAR  248.  003700  LBO: -00023233  FIXED 

RSDVIH  225.  040000  LB0:-00023666  FIXED 

MCRPAR  150.  014000  LBO J-00023314  FIXED 

OTLPAR   50.  015000  LBOt-00023365  FiXED 

SIPPAR   50.  007400  LB0;-00023464  FIXED 


TTOJ 
TTOI 
DDOt 
DDO: 

vmr:>set  /pool 

P00L=450 : 410 . 5  00410 . 

VMR> 

VMRS^Z 

>f 

When   this   command 
read<:i    to    run. 


:>» 
>» 

>REM 
>SET 
>TIM 
12:20:01 

>J 
>8 


file  completes*  aour  RSX-llS  system  is 


...VMM 
/UIC=C2»2003 


07-N0V-81 


;:eof> 
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SYSTEM  GENERATION  ON  A  VAX/VMS  HOST 


VAX/VMS  uses  RSX-llM  indirect  command  files  to  generate  an  RSX-llS 
target  system.  This  chapter  explains  how  to  begin  the  system 
generation.  Section  7.1  describes  the  privileges  you  must  have  to  set 
up  and  run  the  system  generation.  Section  7.2  describes  the  procedure 
for  beginning  the  system  generation.  Section  7.3  presents  the 
dialogue  from  an  actual  system  generation. 

You  can  perform  an  RSX-llS  system  generation  on  the  host  system  disk 
or  on  another  disk.  If  you  use  the  host  system  disk,  you  can  select 
group  numbers  during  the  system  generation  procedure  for  the  RSX-llS 
system  and  Executive  files  so  that  they  will  not  conflict  with  files 
already  on  the  disk.  The  valid  group  numbers  you  can  select  are  3 
through  10.   The  default  group  is  3. 

You  can  also  select  the  group  numbers  if  you  use  a  disk  other  than  the 
host  system  disk.  In  this  case,  the  valid  group  numbers  are  1  through 
10  for  the  system  files  (1  is  the  default)  and  1  through  11  for  the 
Executive  files  (11  is  the  default). 

If  you  select  alternate  group  numbers  for  the  system  and  Executive 
files,  note  that  you  must  explicitly  specify  the  UFD  in  the  command 
line  whenever  you  want  to  use  such  files  as  the  system  object  library 
(SYSLIB.OLB)  or  the  system  macro  library  (RSXMAC.SML).  Norma. ly,  the 
Task  Builder  and  the  MACRO-11  Assembler  expect  to  find  these  libraries 
in  UFD  [1,1].   See  Section  4.7  for  more  information. 

If  you  generate  more  than  one  RSX-llS  system  onto  the  same  target  disk 
by  specifying  additional  system  and  Executive  group  numbers,  the  disk 
must  have  enough  free  blocks  on  it  to  contain  each  additional  RSX-llS 
SYSGEN.  Each  additional  RSX-llS  system  generation  is  segregated  from 
the  previous  SYSGEN  (s). 

You  must  have  a  CLI  (command  line  interpreter)  symbol  table  of  at 
least  40  pages  to  perform  an  RSX-llS  system  generati  ,  Because  the 
table  is  established  when  the  system  is  booted,  you  i^ust  reboot  the 
system  to  set  a  new  symbol  table  space  if  it  is  not  already  adequate. 
You  can  determine  your  current  symbol  table  size  by  running  the  VMS 
SYSGEN  utility.  To  increase  the  symbol  table  space,  run  VMS  SYSGEN  to 
set  a  new  value  for  CLISYMTBL  and  then  reboot  the  system  (see  the 
VAX- 11  Software  Installation  Guide)  .   For  example: 
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tw.  ime: 
k-ASsword: 


SYSTEM/CLI-MCR 


>  RUN  SYS$SYSTEM:SYSGEN 
SYSGEN>  SHOW  CLISYMTBL 

CLISYMTBL 
SYSGEN>  SET  CLISYMTBL  40 
SYSGEN>  SHO  CLISYM 

CLISYMTBL 
SYSGEN>  WRITE  CURRENT 
SYSGEN>  EXIT 
> 


20 


40 


20 


20 


10 


10 


128   Pages 


128  Pages 


The  numbers  shewn  in  the  CLI  symbol  table  are  the  current  number  of 
pages,  the  default  number,  the  minimum  number,  and  the  maximum  number. 
After  you  have  made  the  desired  changes  to  the  symbol  table,  reboot 
the  system,  and  log  in  again. 


NOTE 

If  you  are  generating 
operating  system  on  a 
operating  system,  you  do 


an  RSX-llS 
VAX/VMS  V3.0 
not   have   to 


increase  the  CLISYMTBL  space. 


Note  that  the  VAX/VMS  version  of  the 
image  files  with  a  file  type  of  .EXE. 


RSX-llM  Task   Builder   produces 


If  you  want  to  build  a  task  on  VAX/VMS  with  the  On-Line  Debugging  Tool 
(ODT) ,  you  must  explicitly  include  ODT/DA  on  the  input  file  side  of 
the  task-build  command  line.  You  must  include  the  debugging  switch 
with  the  ODT  file  name  and  you  must  have  the  terminal  included  in  your 
RSX-llS  system.  The  following  command  line  shows  how  to  include  ODT 
for  an  RSX-llS  task  built  under  a  VAX/VMS  system: 

MCR>TKB  TEST=[g,l] ODT/DA, TEST 


NOTE 

Normally,  the  ODT  object  file  (ODT. OBJ) 
is  on  the  target  system  disk  in  UFD 
[1,1].  If  during  system  generation, 
however,  you  selected  an  alternate  group 
number  for  the  system  files,  you  must 
explicitly  specify  this  group  number  (g) 
in  the  TKB  command  line. 


7.1   ESTABLISHING  VAX/VMS  PRIVILEGES 

You  must  be  logged  into  the  VAX/VMS  system  with  certain  privileges  in 
order  to  set  up  and  run  the  RSX-llS  system  generation.  If  you  run  the 
system  geneidtion  from  the  system  manager's  account  that  is 
distributed  with  the  VAX/VMS  system  (as  long  as  its  privileges  have 
not  been  altered) ,  you  automatically  have  access  to  the  following 
required  privileges: 
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1.  Change  Mode  to  Kernel  Privilege  (CMKRNL) ,  which  allows  you  to 
change  default  UICs  and  directories  (you  must  set  this 
privilege  before  you  can  set  the  remaining  privileges) 

2.  Logical  I/O  Privilege  (LOG_I0) ,  which  permits  RSX-llM  VMR  to 
do  logical  I/O  on  task  image  files 

3.  Volume  Protection  Override  Privilege  (VOLPRO) ,  used  only  with 
an  RSX-llS  magnetic  tape  distribution  kit,  so  that  you  can 
mount  the  tape  with  the  /FOREIGN  qualifier 

4.  System  Protection  Privilege  (SYSPRV) ,  used  to  allow  you  to 
create  files  in  directories  not  owned  by  the  current  UIC. 

If  you  have  the  SETPRV  privilege,  you  can  establish  the  required 
privileges  with  the  following  MCR  command: 

>SET  PROC/PRIV-(privilege[,.. .] ) 

Use  the  following  MCR  command  lines  to  find  out  what  privileges  you 
have: 

Username:   SYSTEM/CLI=MCR 
Password: 

>SHO  PROC/PRIV 

You  should  have  CMKRNL,  LOG_IO,  VOLPRO,  and  SYSPRV  (the  ones  described 
above).  Using  these  privileges  is  described  in  the  VAX/VMS  System 
Manager' s  Guide. 


7.2   RUNNING  RSX-llS  SYSTEM  GENERATION  ON  VAX/VMS 

The  following  steps  permit  you  to  begin  an  RSX-llS  system  generation 
on  VAX/VMS.  After  you  log  into  the  system  and  mount  the  RSX-llS 
distribution  kit,  you  can  proceed  with  the  RSX-llS  system  generation. 

If  your  distribution  kit  is  on  disk,  use  the  following  steps: 

1.  Log  in  on  the  VAX/VMS  system  with  the  /CLI=MCR  qualifier  so 
that  you  can  use  MCR,  which  is  the  required  CLI  for  the 
RSX-llS  system  generation. 

Username:   SYSTEM/CLI=MCR 
Password: 

2.  Set  up  the  required  privileges  as  described  in  Section  7.1. 

3.  Mount  the  RSX-llS  distribution  kit. 

>MOUNT  ddnn:   llSKITl 

4.  Set  your  default  disk  and  UIC  to  [2,200]  on  the  target  disk. 

>SET  DEF  ddnn: [2,200] 

5.  Copy  [2, 20] 11SGEN.CMD  from  the  IISKIT  distribution  medium  to 
UFD  [2,200]  on  your  target  disk. 

>PIP  ddnn:/NV=ddnn: [2, 20] 11SGEN.CMD 
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6.   Make  sure  your  UIC  is  set  to  [2,200]  and  execute  the  RSX-llS 
system  generation  procedure. 

>SHO  DEF 


>§11SGEN 
If  your  distribution  kit  is  on  tape,  use  the  following  steps: 

1.  Log  in  on  the  VAX/VMS  system  with  the  /CLI-MCR  qualifier  so 
that  you  can  use  MCR,  which  is  the  required  CLI  for  the 
RSX-llS  system  geneiation. 

User name:   SYSTEM/CLI-MCR 
Password: 

2.  Set  up  the  required  privileges  as  described  in  Section  7.1. 

3.  Mount  the  RSX-llS  distribution  kit  foreign. 

>MOUNT  mmnn:/FOR 

4.  Mount  the  target  disk. 

>MOUNT  ddnn:  volume-name 

5.  Set  your  default  UFD  on  the  target  disk  to  be  [2,200]  and 
create  this  UFD  on  the  disk. 

>SET  DEF  ddnn: [2,200] 
>UFD  ddnn: [2,200] 

6.  Copy  [2,20]11SGEN.CMD  from  the  distribution  medium  to  UFD 
[2,200]  on  your  target  disk. 

>FLX  ddnn : /RS=mmnn : [ 2 , 20 ] 1 ISGEN . CMD/DNS : 1600/DO/RW 

7.  Dismount  the  distribution  kit. 

DM0  mmnn:/NOUNLOAD 

(Specifying  the  /NOUNLOAD  keyword  allows  you  to  dismount  and 
remount  the  tape  without  having  to  reload  it.) 

8.  Make  sure  your  UIC  Is  set  to  [2,200]  and  execute  the  RSX-llS 
system  generation  procedure. 

>SHO  DEF 


>§11SGEN 

All  the  files  needed  for  the  system  generation  are  copied  to  the 
target  disk  by  11SC0PY.CMD,  which  is  invoked  by  llSoEN.  The 
file-copying  process  takes  approximately  60  to  90  minutes. 

Note  that  to  save  a  bootable  RSX-llS  system  image  onto  the  system 
console  device,  you  must  use  the  device  name  CS:.   For  example: 


7-4 


SYSTEM  GENERATION  ON  A  VAX/VMS  HOST 


VMR><RET> 
ENTER  FILENAME: 
VMR>SAVE  CS: label 

VMR  is  documented  in  the  RSX-llM/M-PLUS  Syste.n  Management  Guide. 


7.3   ACTUAL  DIALOGUE  --  RSX-llS  SYSTEM  GENERATION  ON  A  VAX/VMS  HOST 

This  section  contains  the  actual  terminal  dialogue  from  an  RSX-llS 
system  generation  on  an  VAX/VMS  host. 

The  dialogue  and  procedures  in  Phase  1  are  the  same  as  those  for  an 
RSX-llM  host.  For  detailed  explanations  of  the  Phase  1  system 
generation  questions,  see  the  RSX-llM  System  Generation  and 
Installation  Guide. 

The  system  generated  in  the  example  supports  the  following  hardware 
configuration  for  a  PDP-11/60  processor: 

124K  memory 

60   cycle  line  clock 

RK05  cartridge  disk  controller  with  1  drive 
RLOl  cartridge  disk  controller  with  2  drives 
RK06  cartridge  disk  controller  with  2  drives 
TE16  magnetic  tape  controller  with  1  drive 
null  device  driver 
DLll  terminal  interface 

The  following  software  support  is  included: 

•  Large  (20K)  RSX-llS  Executive 

•  Support  for: 

Memory  parity  support 

Cache  memory 

Executive  common 

Memory  management  directives 

Send/ receive-by- reference  directives 

Get  mapping  context  directive 

Address  checking 

I/O  rundown 

Loadable  device  drivers 

ASTs 

Cancel  selective  marktime 

Powerfail  recovery 

Loi  ical  device  assignment 

System-controlled  partitions 

Group  global  event  flags 


•  TKTN 

•  Full-duplex  terminal  driver 

•  Basic  MCR  with  support  for  the  OP  '  and  ATL/TAL  commands   and 
full  error-message  test 

•  OTL  with  support  for  full  error-message  text  and  for   all   OTL 
devices  generated  into  the  RSX-llS  system 

•  SIP  with  support  for  full  error-message  text  and  for   all   SIP 
devices  generated  into  the  RSX-llS  system 
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•  CDA  for  crash  dump  analysis  on  the  host  system 

•  RSX-llS  Subset  File  Control  Services  (FCS) 

•  SETTIM 

The  system  qeneration  is  being  performed  on  a  host  VAX/VMS  system  with 
an  RK07  as  the  ".arget  disk.  The  RSX-llS  release  kit  is  a  2400-foot 
magnetic  tape. 

Questions  calling  for  a  YES/NC  answer  can  be  answered  by  pressing  the 
RETURN  key  for  a  "NO"  answer. 

You  can  also  answer  queitions  asking  for  a  value  and  displaying  a 
default  value  by  pressing  the  RETURN  key  to  specify  the  default  value. 

Notes: 

1.  You  might  want  to  do  a  preliminary  system  generation  before 
you  do  your  actual  SYSGEN.  To  do  a  preliminary  SYSGEN,  you 
invoke  the  command  file  for  Phase  1  of  the  SYSGEN  (gllSGEN) 
and  answer  YES  to  the  question,  "Do  you  want  to  inhibit 
execution  of  MCR  commands?" 

Phase  1  continues,  '.jUt  the  answers  you  give  to  the   questions 

are   placed   in   a   saved  answer   file  instead  of  being  used 

immediately.   When  Phase  1  finishes,  you  reinvoke   11SGEN.CMD 

to   run   the   phase  again.  This  time,  you  do  not  inhibit  MCR 

command  line  execution  and  the  system  uses  the  answers  in  the 
saved  answer  file. 

Doing  a  preliminary  SYSGEN  saves  time  and  prevents  mistakes. 
The  sample  dialogue  shows  a  preliminary  SYSGEN  being  done 
before  the  actual  SYSGEN  is  done. 

2.  During  Phase  1  of  the  system  generation  procedure,  11SGEN.CMD 
asks  for  tlie  device  configuration  of  your  system,  the  system 
directives  you  would  like  in  the  Executive,  and  the  type  of 
terminal  driver  you  want  to  use.  For  these  questions,  you 
can  print  out  a  table  of  the  available  options  before  you 
answer  the  question. 

3.  During  Phase  1,  you  can  also  se  .ect  different  group  numbers 
for  the  system  and  Executive  files.  In  the  sample  SYSGEN, 
group  number  3  is  selected  for  the  system  files  and  group 
number  10  for  the  Executive;  files.  (Vhe  default  group 
numbers  are  1  and  11,  respecti  -ely. ) 

■Following  is  the  actual  terminal  dialogue  from  an  RSX-llS  system 
generation  on  a  VAX/VMS  V3.0  host. 


• 
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U*«rnaM*t    JOHNSON/CLI-HCR 
Pastuord: 

Uelcoii*   to   VAX/VHS   Vrrsion   V3.0 

>  SET  '•ROC/PRIV=<CHKRNLfLOO_IOFVOLPRO.SYSPRV) 

>  SHO  PROC/PRIV 

19-APR-19e2  10;48: 18.49  .OPAOi        U««r  i    JOHNSON 

Procass  privileflas  ! 

CHKRNL  aau  chana*  nod*  to  karnal 

LOG-ID  »at.  do  logical  I/O 

SETPRV  iia»  sat  an><  privilaaa  bit 

THPHBX  mav  create  ta*f>orarw  nailbo! 

NETHBX  aau  create  network  device 

VOLPRO  lis^  override  voluae  protection 

SYSPRV  ma<>i  access  objects  via  svstca  protection 

>  ALL  MSO: 
-hSAO:  ALLOCATED 

>  ALL  OMi: 

-DHAi:  ALLOCATED 

>  INI    DM1  :    llSDSK/fTRUCTlJRE  =  l 

>  KOU  DM1 :  IISDSK 

XMOUNT-I-MOUNTED>  IISDSK        Mounted  on  .DMAi: 

>  SET  DEF  DM1 :C2. 2003 

>  UFD  DM1 :C2> 2003 
■  MOU  MSO : /FOR 
ZMOUNT-I-MOUNTEDt   iiounted  on  _MSAO! 

>  FLX    DMi:/RS=MS0:C2.20311SGEN.CMD/DO/RU/DNS:U00 

>  SHO    DEF 
DM1:C2f200] 

>  eUSGEN 
f 

T    RSX-llS    Version    4.0    BI.32    S^istea    Generation    done    on    VAX/VMS 

i 

i    Copsriaht  (C)  1979fl981 

i    Digital  EauipMent  Corporationt  Hawnardt  Mass. 

i    All  Ridhts  Reserved. 

) 

i 

i    RSy-llS    stisteii    feneration   set-up    section 

f 

i    The  stjsteii  device  is  the  disk  on  which  all  of  th»  hostr  VAX/VMSt 

r  susteii  files  are  stored.   If  sour  IIS  target  disk  is  the  sustea  device 

;  then  there  nau  possibltj  be  a  conflict  in  soke  file  naaes  (e.d.f  SY5LIP>< 

i 

>«IS  THE  TARGET  DISK.  SYO!,  THE  SYSTEM  DEVICE?  CY/N]: 

XHHAT  IS  THE  GROUP  NUMBER  FOR  THE  SYSTEM  FILES  CO  Rtl-lO  D!13:  3 

>«UHAT  IS  THE  GROUP  NUMBER  FOR  THE  EXECUTIVE  FILES  CO  Rtl-ll  D:113!  10 

>«TARGET  DEVICE  NAME  CS3:  DM1 : 

>  SET  DEFAULT  DM1 S 

>  ASN  dmi:=sy: 

>  ASN  DMi:«SYOt 

>  ASN  dmi:°lb: 

>  ASN  Dhi:=LBo: 

>  ASN  mp:»mpo: 

>  ASN  TK!=TKO! 

>  ASN  DM1:C3.54311MTKB.TSK»TKB 

>  ASN  DMi:C3.543llMVMR.TSK»VMR 

>«COPY  THE  RSX-nS  DISTRIBUTION  FILES  TO  THE  TARGET  DISK?  CY/N3:  Y 

XENTER  DEVICE  FOR  THE  RSX-llS  DISTRIBUTION  KIT  rS3:  MSO: 

>»IS  THE  RSX-llS  DISTRIBUTION  KIT  ON  A  2400  FOOT  REEL?  CY/Ni:  Y 

i 

i    Place  the  tape  labeled  llSKITl  on  HSOS 

I 

>»I8  THE  TAPE  READY  ON  HSOl?  CY/N})  Y 
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>  HOU  HSO:/F0R 

XHOUNT-F-DEVHOUNTt  devic*  im  a] raadM  •ountvd 

>  FLX  DNlt/RS-NSOK200>200]118C0PY.CH0/D0/liU/0N8:i«O0 

>  UFD  SY:C3>n 

>  UFO  SY:C3i2] 

>  UFD  SY:C3f43 

>  UFD  SY:t2r20] 

>  UFD  SY:C3»543 

>  UFD  SY:C3r&03 

>  UFD  SY:C3»64D 

>  UFD  SY:C3.203 

>  UFD  SY:C3t243 

>  UFD  SY;tt0.203 

>  UFD  SY: CIO. 243 

>  UFD  SY!C3.303 

>  UFD  SYSC3.343 

>  UFD  SY:tlOr303 

>  UFD  SY:C10.343 
UFD  SY;C45.t03 

;  UFD  SY:[45.203 

>  UFD  SY:C45.243 

>  UFD  SY:C45.303 

>  UFD  SY:t45.34a 

>  UFD  SY;[10.103 

>  PIP  C3.13EXEMC.«!«/DE/NM.EXELIB.0l BI«.EXEIITL .OBJ» «.UCTnF .OPJ; « 

>  PIP  C3rl3DIRSYM.OBJ»«/DE/NMfGCMI.  .Oej»«fARnH.0B.)J«.ODT.nBJf« 

>  PIP  n3f 13LPA.OBJS«/DE/NM.RSXMAC.SML8».FCSRES.MAC»« 

:>  PIP  C3»13PURUDC.OB.Jf*/DE/NM.PURISAfOBJf«.PURinR.OB.JJ«fl.PS.OBJS* 

>  PIP  /FR 

DM1!  HAS  52687.  BLOCKS  FREE?  il03.  Bl OCKS  USED  OUT  OF  53790. 
LARGEST  CONTIGUOUS  SPACE  =  258?3.  BLOCKS 

>  SET    UIC    C3.13 

>  FIX    C3f 13=HS0:tI .13«.«/DNS}1600 

.:  FLX  C3.203  =  MS0!C1  f?03».*/DNS:i600 
:  FLX  C3.243=HS0! C1t243*.«/DNS:1600 
:      FLX    C3.543/C0/Eil:180.=HS0;C1.54311MVHR.TSK/DNS!IA0O 

>  FLX    C3.54]/CO/BL:180.=HSO:C1.54311MTKB.TSK/DNS:1AOO 
;     PIP    C3.'i4311MVMR.TSK/PU/NMfnMTKB 

>  fLX    C2»2003=MSO:C200.2003«.».C2r203nSGEN2.CMD/DNS:i600 

>  FLX    C2.203=MS0:C2.203*.«/DNS!1400 

>  PIP  C2f20311SGEN.CMDS«/DE/NH.llSGEN2.CMD!« 
:>  FLX  C45,103  =  HS0!C45.101*.«/DNS!t600 

>  FLX  C45.203=HSO:C45.203».«/DNS:i600 

>  FLX  C45.243=MS0;C45.24.1«.»/DNS!1A00 

>  FLX  C10.103=MSO:Cllf 103«.«/DNS:i600 

>  PIP  C3»203«.*/PU/NM»C3»243«.« 

>  PIP  C2.203«.»/PU/NM.C45.103».«.C45.203«.«»C45.243«.« 

>  PIP  /FR 

DM1!  HAS  43045.  BLOCKS  FREE.  10745.  BLOCKS  USED  OUT  OF  53790. 
LARGEST  CONTIGUOUS  SPACE  =  2334A.  BLOCKS 


.  Distribution  kit  cof'U  is  now  coiiPlete 

>  DM0  Mso; 
5 

j  You  in9'i    nog  remove  «our  distribution  Kit  fro»  drive  MSO  5  . 
f 

>  SET  UIC  C 2. 200 3 
f 

i    Bid  disk  distribution  kit 

f 

>«3.    DO    YOU    WANT    TO    INHIBIT    EXECUTION   OF    MCR    COMMANDS?    CY/N3!    Y 
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«S.  ARE  YOU  OENERATINO  A  HAPPED  SYSTENT  CY/ND*.  Y 

«7.  USE  AN  INPUT  SAVED  ANSWER  FILET  CY/NIS 

«10.  NAME  OF  OUTPUT  SAVED  ANSWER  FILL  CDS  SYSSAVED.CND3  CSlt 

Phase  I  output  saved  answers  created  in  file  PHI : C2r200]SYSSAVFn.CNllt 1 


Target  conf isuration 


124. 


«1.  PROCESSOR  TYPE  CDS  11/343  CS3:  11/60 

»3.  HEMORY  SIZE  (IN  K-UORD  BLOCKS)  CD  R:U-124  D!163S 

«4.  INCLl/DE  SUPPORT  FOR  K-SERIES  DEVICES?  CY/ND: 

«8.  EXTEND  INSTRUCTION  SET  (EIS)  PRESENT?  tY/N3: 

*9.  IF  USINO  KWll-P  AS  SYSTEM  CLOCKS  NUMBER  OF  INTRPS./SFC.  CD  RS0-10003S 

»10.  LINE  FREQUENCYS  A-  60    HZ  B-  50    HZ  CDS  A3  CSjS 
>«11.  KMll-Y  WATCHDOG  TIMER  SUPPORT?  CY/N3S 
>«12.  MEMORY  PARITY  SUPPORT?  CY/N3S  Y 

•13.  CACHE  MEMORY?  CY/N3S  Y 


The  response  to  tha  followina  auestion  specifies  the  highest  interrupt 
vector.   If  Hou  respond  with  a  value  less  '.han  or  euual  to  400r  SYSGEN 
will  assign  the  value  associated  with  the  highest  interrupt  vector 
specified  during  the  Peripheral  Section.   Therefore?  if  aour  ssstei* 
will  include  devices  that  are  not  specified  durin<<  the  Peripheral 
Section  and  which  have  vectors  above  400  (devices  such  <is  K-serit»s  and 
certain  coanunication  devices)*  specifu  that  value  in  the  next  auestion. 


iriom  ru 


>«14.  HIGHEST  INTERRUPT  VFCTOR  CO  RS0-7743S 

i  For  device  conf  i  aurat  ion  S  '*'  Prints  devi(-e  tablet  '.*  Teriainates 

S  '?'  Prints  current  conf isurstion 

i  Enter  devices  and  nuaber  of  controllers  for  devices  which  reouire  drivers 

>«15.  DEVICES  CS3S  « 


»     Device  codes  for  A/D  and  industrial/laborator<j  devicesS 

f 

i  AD-  ADOl-D  A/D  Converter 

»  AF-  AFCll  A/0  Converter 

t  AR-  ARll    Laboratort^    Subsvtstea 

J  IC-  ICRll/ICSll  Industrial  Control  Subsastea 

J  IP-  IP11/IP300  Industrial  Control  Subsustea 

i  IS-  DRSll/DSSll  Industrial  Control  Subsastea 

i  LA-  LPAll  Laboratora  Subsastea 

»  LS-  LPStI  Laboratora  Subsastea 

»  UD-  UDAll  Universal  Didital  Controller 

i 

i  Device  codes  for  Interprocessor  coaaunication  devicesS 

r 

XB-  DAll-B  Interprocessor  Link 
DLll-E  Interprocessor  Link 
DMCll-E/DMRll  Interprocessor  Link 
DPll  Sanchronous  Interface 
DOll  Sanchronous  Interface 
DUll  Sanchronous  Interface 
DUPll  Sanchronous  Interface 

codes  for  unit  record  devicesS 

CRll/CMll-E  Card  Reader 

VTll/VSAO  Graphics  Subsastea 

LAlBO/LPll/LSll/LVll  Line  Printer 

PCU  Paper  Tape  Punch 

PCll/PRll  Paper  Tape  Punch  and  Reader 

Device  codes  for  disks  devicesS 


i 

XB- 

i 

XL- 

i 

XM- 

t 

XP- 

t 

XQ- 

> 

XU- 

t 

XW- 

i 

i 

Device 

T 

i 

CR- 

1 

GR- 

♦ 

LP- 

» 

PP- 

i 

PR- 

1 
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I  DB-   RP04/RP05/RPOA   Di«k    Drive 

I  DD-    TU58    :«ririd«*   DECiai»«    II 

i  DF-  RFll  F^xad  H*ad  Disk  Driv* 

I  DK-  RK03/RK0S  Disk  Drive 

i  Dl.-  RL01/RL02  Di«k  Driv* 

I  DH-  RK06/RK07  Disk  Drive 

I  DP-  RP02/RP03  Disk  Drive 

I  DR-  Rn02/RH03/RHOS/RN80/RP07  Dimk  Drive 

I  OS-  RS03/RS04  Fixod  He^d  Disk  Drive 

I  DT-  TUS6  DECiepe 

I  tiU-  UDA50  Unibus  Disk  Adapter 

I  [IX-  RXOl  Floppw  Disk  Drive 

»  DY-  RX02  Floppa  Disk 

t  EH-  HLll  Non-Rotatina  Electronic  Henorw 

» 

f  Device  codes  for  Haanetic  tape  devices: 

) 

I  CT-  TU60  Cassette  Tape  Drive 

)  HF-  TU78  Haatape  Drive 

»  MM-  TUU/TU45/TU77/TE14  Maatape  Drive 

»  MS-  TS04  Maat.ape  Drive 

i  MT-  TU10/TE10/TS03  Maatape  Drive 

r 

i  Device  codes  for  terainal  interface  devices! 

i 

i  YH-  DHll  Asynchronous  Terminal  Interface 

t  Y.»-  DJll  Asanchronous  Terminal  Interface 

I  YL-  DL11-A/-B/-C/-D/-E/-J/-U  Asynchronous  Terainal  Interface 

i  YZ-  DZtl  Asanchronous  Terain^l  Interface 

) 

i  Device  codes  for  pseudo  devices! 

V 

i  CO-  console  device 

f  Nl.  -  null  device 

5 

>  Enter  responses  as!  devl=nuaber  control ler3rdev2'^nuMber  controllerst  ■•> 

i  It'  3  device  is  speTified  without  the  nuaber  of  (;ontrollersr  the  nuaber 

»  of  controllers  defaults  to  !• 

f 

f  EKdOPle:  DK>DH  =  2iYL.iNL. 

p 

: :*15.  DEVICES  CS3:  DM.DK .DL. MM. YL.NL. 

i 

i    Processor: 11/60   Me«ioru  Si ze! 124K. Happed   SasteatRSX-llS 

{ 

»  Host  conf iauration 

f 

>*\,  IS  A  LINE  PRINTER  AVAILABLE?  CY/N3J  Y 

>»2.  SPOOL  ASSEMBLY  LISTINGS  AND  EXECUTIVE  AND  DRIVER  MAPS?  CY/Ni: 

>*3.  HOES  THE  LISTING/MAP  DEVICE  HAVE  AT  LEAST  120  COLUMNS?  CY?N3:  Y 

>*4.  ASSEMBLY  LISTINGS  DEVICE  (DDU!)  CO!  'NL!'3  CSD! 

;»5.  MAP  DEVICE  FOR  EXECUTIVE  AND  DEVICE  DRIVERS  (DDU!)  CD!  SY!3  CSD! 

9 

>«EOS  «  DO  YOU  UANT  TO!  <CR:>-C0NTINUE  R-REPEAT  SECTION  E-EXIT  P-PAUSE  CSJ! 
) 

i 

i    Executive  Options 

p 

i  Answer  Y(ES>  if  the  followina  support  is  desired 

» 

>«6.  EXECUTIVE  COMMON?  CY/N3!  Y 

>»7.  MEMORY  MANAGEHENT  <PLAS)  DIRECTIVES?  CY/Nl!  Y 

>«8.  SEND/RECEIVE  BY  REFERENCE  DIRECTIVES?  CY/N3!  Y 

>»9.  GET  MAPPING  CONTEXT  DIRECTIVE?  lY/NI!  Y 

r  Address  checkina  support  will  be  included 

i  I/O  rundown  support  will  be  included 


7-10 


SYSTEM  GENERATION  ON  A  VAX/VMS  HOST 

>«1S.  LOADABLE  DEVICE  ORIV.1R8T  CY/N1S  Y 

>*16.  SHOULD  THE  DEFAULT  FOK  ALL  APPLICABLE  DRIVERS  BE  LOADABLET  CY/Ni:  Y 

I  AST  tuppori  uill  b*  included 

>«18.  INCLUDE  SUPPORT  FOR  CANCEL  SELECTIVE  HARKTINET  CY/Nlt  Y 

>«19.  TASK  TERMINATION  AND  DEVICE  NOT  READY  HESSAOES  (TKTN)T  CY/Nli  Y 

>«20.  POWER  FAIL  RECOVERYT  CY/Ni:  Y 

>«22.  LARGE  ( 20K )  EXECUTIVE?  CY/Nlt  Y 

>«23.  LOGICAL  DEVICE  ASSIGNHENT?  CY/NIS  Y 

>«2!S.  no  YOU  INTEND  TO  INCLUDE  A  USER-WRITTEN  DRIVER?  CY/NJS 

>»30.  EXECUTIVE  DEBUGGING  TOOL  (XDT>?  CY/N3: 

:>*32.  INCLUDE  SUPPORT  FOR  COHHUNICATIONS  PRODUCTS?  CY/Nli 

>*33.  SYSTEM  CONTROLLED  PARTITIONS?  CY/N3:  Y 

-«36.  GROUP  GLOBAL  EVENT  FLAGS?  Cf/N,i:  Y 

>  For  directives: 
f 

s  «  -  Prints  the  table 

»  .  -  rerninates  inauirs 

i  X  -  Gets  all  valid  directives  and  icrninates  inauirw 

r 

;*37.  ENTER  CODE  FOR  SYSTEM  DIRECTIVES  CSi:  « 

f 

•  A-  Get  partition  parameters     B-  Get  task  parameters 

i  C~    Send/Receive  It-  Alter  priority 

»  E-  E::tend  task-  F-  Connect  to  interrupt  vector 

f  n-  Gst  sense  switch  H-  Set  swstea  ti»e 

S  I-  Stop  bit  J-  Specifw  reouested  exit  AST 

i  K-  Parent  offspring  tasking     L-  Parent  offsprina  taskin*  with  chaininM 

f 

Enter  responses  as  codelcode?code3<  t  •  (no  coaiias)  (e>!i*S  ABCDFi) 

i 

-*37.  ENTFR  CODE  FOR  SYSTEM  DIRECTIVES  CSi:  ABCDEFHIJK. 

■«38.  NUMBtR  OF  FRE-ALLOCATFD  010  PACKETS  CD  R:0-15  C'.Si: 

>«39.  SIZE  OF  DATA  TRANSFER  VECTOR  IN  WORDS  CD  r:0-33  D:333: 

>»40.  ROUND-ROBIN  SCHEDULING  INTERVAL  IN  TICKS  CD  R:0-1000  D:53: 

:»41.  HIGHEST  PRIORITY  CLASS  FOR  CONSIDERATION  CD  R:1-249  D:1503: 

«43.  LOUEST  PRIORIIY  CLASS  FOR  CONSIDERATION  CD  R:1-150  DUD: 

»48.  SrSTFM  CRASH  REGISTER  AND  STACK  DUMP  DEVICE  CSR  CO  R;0-177700  DJ1775A43J 

«50.  TYPE  OF  CRASH  DUMP  ANALYSIS?  A-  PANIC  B-  CRASH  DUMP  ANALYSIS  (CDA)  CS3:  B 

♦51.  CDA  OUTPUT  NOTIFICATION  DtVICE  CSR  CO  R : 1*0000-1 77700  D:1775643: 

>»52.  ENTER  CDA  MEMORY  DUMP  DEVICE  MNEMONIC  (DOUt)  CS  R:3-43;  DKO*. 

>«t,3.  ENTER  CDA  MEMORY  DUMP  DEVICE  CSR  CO  R* ' .0000-177700  D: 1774043  J 

r 

>  lerniirisl  driver  options 

:xi.  lERMINAL  DRIVER  DESIRED  (A/B/C/D>  «  PRINTS  TABLE)  CS}:  t 

i  Teriiinal  drivers:   A-  Tailorable  half  duplex 
(  6-  Tailored  half  duplex  (user-oriented) 

i  C-  Full  duplex 

(  D-  Baseline  half  duplex 

t 

>«1.  TERMINAL  DRIVER  DESIRED  (A/B/C/Df  «  PRINTS  TABLE)  CS3:  C 
«2.  UNSOLICITED  INPt!T  TIMEOUT  VALUE  IN  SECONDS  CD  R:0-2S5  D:120]: 

Answer  Y(ES>  if  the  following  support  is  desired 

«6.  UNSOLICITED  INPUT  CHARACTER  AST?  CY/Ni:  Y 
>»B.  BREAKTHROUGH  WRITE?   CY/NJ:  Y 

i  CTRL/R  support  will  be  included 

>«10.  ESCAPE  SEQUENCE  HANDLING?   CY/N3:  Y 

>«11.  GET  MULTIPLE  CHARACTERISTICS?   CY/N3:  Y 

>«12.  SET  MULTIPLE  CHARACTERISTICS?   CY/N38  Y 

>*13.  GET  TERMINAL  DRIVER  OPTIONS?   CY/N3: 

>»17.  READ  AFTER  PROMPT?   tY/N3:  Y 
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>«20.  CRT  RUBOUT  SUPPORT?   CY/NJJ  Y 
»2S.  HARDWARE  UNRECOVERABLE  INPUT  ERROR  NOTIFICATION?   fY/Nli 
»2A.  DEVICE  INDEPENDENT  CURSOR  POSITIONING?   CY/NIt  Y 

«EOS  «  DO  YOU  WANT  TOt  <CR>-CONTINUE  R-REPEAT  SECTION  E-EXIT  P-PAUSE  C83: 

Susteii  Options 

Answer  Y(ES>  if  th*  followind  support  is  d*sir*d 

«11.  WHAT  NAhE  WOULD  YOU  LIKE  TO  GIVE  YOUR  SYSTEH  TDt  RSX11S3  CS  R'.O-AJ: 

*EOS  *  DO  YOU  WANT  TO:  <CR>-C0NT1NUE  R-REPEAT  SECTION  E-EXIT  P-PAUSE  CSJt 

Think  ina  • . • 

End  of  Executive  option  feneration  at  12:59!23  on  19-APR-19B2 

F'eripheral  Conf  iflurat  ion 

Fa rametert  appearina  m  sauare  brarKets  T...]'  can  only  be 

sf-ecified  for  the  first  controller  of  a  partici.il8r  device. 

F'a  rsmeters  sppeanna  iri  parentheses  '(...)*  onlv  need  be  specified 

if  tiie  indic-jted  option  is  present  on  the  t3r«let  sssteii< 

The  rjefdult  for  loadable  drivers  has  been  set  to  «TRUE*. 

To  overridi?  this  t*»tting  enter  R  (resident)  as  the  first  paraneter 

for  the  first  cortroller  of  the  specified  device. 

A.'Ii  dnd  Laboratory  devices:  None  specified 

In  t-:?  rp  roces&or  couiBiun  i  cat  i  on  devices!  None  specified 

Urnt  recjrd  devices!  None  specified 
IiisFs:  DKr  DLi  DM 

For  the  third  pera»eter  of  the  next  auestion>  enter  the  nukher 
of  RKO!-J  drives  wour  tarset  s^tstea  has.  Reali<;e  that  an  RK05F 
is  i    tiy.ed    media  RK05  drive  eauivalent  to  two  reaovahle  RK05 
drive<=.   St'ecifa  everu  RK05F  as  two  RK05s . 

Enter  CL/'R»3  vertorr  CSR»  nuMber  of  drives  for* 

*3.  DK  CONTROLLER  0  CD!  220tl774043  [83!  fil 

*3.  DL  CONTROLLER  0  CD!  160il74400J  CS3:  rf2 

«53.  CONTR  0  UNIT  0.  IS  AN  RL01/RL02  CDt  RLOID  CS3: 

«53.  CONTR  0  UNIT  1.  IS  AN  RL01/RL02  CD!  Rl.Ol  3  CS3; 

ENTER  CL/Rf3  vectort  CSR?  +   drives»  O=offset  recoverw/NO^no  offset  r»c.  fori 

«i3.  DM  CONTROLLER  0  CD!  2i0f 177440f f 03  CS3!  >;2 
*54.  CONTR  0  UNIT  0.  IS  AN  RK06/RK07  CD!  RKO^l  CSD! 
»54.  CONTR  0  UNIT  1.  IS  AN  RK06/RK07  CD!  RK063  CS3: 

rapes!  MM 

Enter  CL/R»3  vectort  CSR»  nuMber  of  drives  for{ 

«  3.  MM  CONTROLLER  0  CD!  224fl724403  CS3!  ffI 
>«51.  MM  CONTROLLER  0  UNIT  0.  FORMATTER  CO  R:C-773! 
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I    Non-rhv»ical    (pmaudo)    dvvlcvs!    COi    NLf    T!r    CLr    LBt    8Y 

i 

t    Tarainal    int*rfac«   d*vic«»*    YL 

I 

I    Entvr    v»ciorf    CSRr    E-DLll-E    aoclvM    •u^^ort/NO^no    tori 

I 

>«2!.  YL  CONTROLLER  0  CD:  60> 177SA0t NOl  CSi: 

I 

>«E08  «  DO  Y1U  WANT  TO:  <CR>-CONTINUE  R-REPEAT  SECTION  E-EXIT  P-PAUSE  CSi: 

I 

I 

I  End  of  int*rru^i  v*ctor  arsa  ha«  ba*n  tat  to  400 

» 

I  Craata  Exacutiva  build  filas 

i 

i 

*l.    00  YOU  UISH  TO  EDIT  ANY  OF  THE  EXECUTIVE  FILES'   TY/Nr. 
r 
i 

•  EOS  «  DO  YOU  UANT  TO:  :CR>-CONT  INUE  R-RFPEAT  SRCTION  E-FXIT  P-P(:iUPE  Cf.]: 

r 

t 

i  Pre^ara  for  ta»t<  building 

I 

t 

f    Claan-u^  e::trariaou«  object  file* 

t 

f 

«EOS  «  DO  YOU  UANT  TO:   OR  -CONTINUE  R-RFPFAT  SFCTION  F-PAUSE  LS]: 
> 
I 

;  END  OF  IISGEN  Phase  I  at  13:02:52  or.  19-APR-1982  | 

i  --    To  cof.tinue  twp*:  ST  2  t  200  111  3GEN2 

>  SHO  DEF 
DMi:C?r200] 
911SGEN 

i    RSX-llS  Version  4.0  Bl 3?  S«stea  Generation  done  on  VAX/VMS 

i    Cop^riflht  (C)  1979.1981 

(  Diait^l  FauiPMent  Corporationt  H^vnardr  ha*s> 

i    All  Riahts  Reserved. 

i 
i 

i    RSX-llS  ssstea  generation  set-up  section 

i 

J  The  sasteii  device  is  the  disl-  on  which  all  of  the  hast»  VAX/VNS. 
»  suste*  files  are  stored.   If  aour  US  target  disk  is  the  sastea  device 
J  then  there  rna-d    possible  be  a  conflict  in  soae  file  naaes  (e.g.?  SVSLIFi). 
f 
»IS  THE  TARGET  DISK.  SYO:.  THE  SYSTEH  DEVICE?  CY/ND: 

•  WHAT  IS  THE  GROUP  NUHDER  FOR  THE  SYSTEM  FILES  tO  R:1-10  DWi',    3 

:  «UHAT  IS  THE  GROUP  NUMBER  FOR  THE  EXECUTIVE  FILES  CO  R:1-11  D:11D:  10 
.'•TARGET  DEVICE  NAME  CSi:  DM1  : 

>  SET  DEFAULT  DM1 : 

>  ASN  dmi:^sy: 

>  ASN  DMi:=SYO: 

>  'SN  dmi:=lb: 

>  ASN  DMi:=LBO: 

>  ASN  mp:=mpc: 
5  ASN  tk:=tko: 

>  ASN  DMi:C3.54]llMTKB.TSK»TKB 
ASN  DMi:C3.54311MVrtR.TSK-VMR 

;«COPY  THE  RSX-llS  DISTRIBUTION  FILES  TO  THE  TARGET  DISK?  CY/N3: 
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I  Bi«  di«k  distribution  kit 

t 

>«3.  DO  rOU  UANT  TO  INHIBIT  EXECUTION  OF  HCR  COHHANDST  CY/N]t 

>»S.  ARE  YOU  GENERATING  A  HAPPED  SYSTEM?  CY/Ni:  Y 

>»7.  USE  AN  INPUT  SAVED  ANSWER  FILE?  CY/Ni:  Y 

>«8.  NAHE  OF  INPUT  SAVED  ANSWER  FILE  CDt  SYSSAVED.CHD3  CSi: 

i 

i    Ph«««  I  inpgt  saved  answers 

»  craated  on  19-APR-1982  at  i2:!;Si37 

(  b«  IISGEN  version  1.S3 

i    ara  fro»  fiX<  _DM1 : C2 i2003SYSSAVED.CHD»3 

f 

♦  50.  NAHE  OF  OUTPUT  SAVED  ANSWER  FILE  CDt  _DM1  ;  C2 .200DSYSSAVED.  CHIO  r.5i: 
! 

8  Phasa  I  output  savad  answers  created  in  file  ..DHl  :  C2f  POOJSYSSAVED.CHDM 

) 

:«11.  USE  SAVED  HOST  CONFIGURATION?  CY/N5:  Y 
•12.  USE  SAVED  PERIPHERAL  CONFIGURATION?  CY/NIS  Y 

>»13.  SKiP  END  OF  SECTION  (EOS)  BREAKPOINTS'  CY/Ni:  Y 

>«M.  SKIP  END  OF  EXECUTION  (EOX)  BREAKPOINTS?  CY/N3;  Y 

>«15.  CLEAN  UP  FILES  FROM  PREVIOUS  GENS?  CY/N3:  Y 

» 

-  SFT  UIC  C3.ia 

PIP    t3.203RSX£iLD.CMri»«/OE/NM 

PIP    t3.?43RSXBL[i.CMDJ«/nE/NMf  TTDRVBLD8* 

PIP    ClOf?0]«.OBJf«/riE/NMf«.UriCJ«i«.ICRJ«f*.IDS>«.».PCS}« 

PIP    LlOf  24]«.0BJJ«/DE/NH.«.UI>Cf«i».ICRS«f  «.IDS;«F«.TTY}«f«.pr;p;» 

FIP    C10.303*.LST»»/0E/NH.C10»141».l STf» 

l-IP    [lOi  10]RSXMC.HACS«/DF/NMiICTABJ«.C?i200]SGNPARH.CM|it« 

FIP    r2r200]RSXBLD.CMDf  «/[iE/NM»TTDRVBLDJ« 

PIP    SY:C11.20DRSXASM.CMD»«/DF/NH.RSXDRVASMf»itl2t?01MrRSFTASHM 

PIP    SY:[:il.:?4DRSXASM.CMDf*/DE/NH.RSXDRVASMJ»ftl2f24  3HCRSETASMf» 


PIP    /FR 

UHi:  MAS  42543.  BLOCKS  FREE.  11247.  Bl OCKS  USED  OUT  OF  53790. 
LARGEST  CONTIGUOUS  SPACE  =  23344.  BLOCKS 

SFT  UIC  CIO. 10  3 

Tarael    ronf  i  aijr?t  ion 

Processor:  11/60      Metiers    Si  2e  :  124K.Happ^ed      Svst.e*  !  RSX-1  IS 


Switch    Register 
Floatina    Point    Processor 
Parita    Meniora 
Crtche    meinoru 


Host    conf  X  aiji-at  ion 
Executive    OF-tions 
Tpmiirisl    diiver    options 
.    Systeni   Options 


Think ina    . . • 


i  End  of  Executive  option  aeneration  at  13:07:4S  on  19-APR-19B2 

t 

f    Peripheral  configuration 

» 

I      Parameters  appearing  in  sauare  brackets  '  C  .  .  .  3  •  ran  onl«  be 
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»  specified    for    th»    fir*t  (-ontrollar    of    •    ^articular   «j*vic». 

5  P»ra»»ters    8Fi>*arln<    in  ^aranthatas    •(...)•    onlw   naad   b»    a^acifiad 

i  if    tit*    indicated    option  it    pra«ant    on    tha    taritat    SM«t*M. 

I 

i  The  default  for  loadable  drivers  has  bean  sat  to  tTRUE*. 

»  To  override  this  settinfl  enter  R  (resident)  as  the  first  ^araaetar 

>  for  the  first  controller  of  the  specified  device. 
i 

»  A/D  and  Lahoratorw  devices:  None  specified 
i 

i     Iriterprocesf.or  conaunicat ion  devices!  None  specified 
t 

Unit  record  devices:  None  specified 

[1 1  si's:     tiKf    [IL»     DM 

Tapes!     MM 

Noti-Fhasical     (pseudo)    devices!    COt    Nl.i    TI.    CL»    LBi    SY 

TtMiiirial     interface    devices!    YL 

SFT    UIC    C3.24D  | 

SET    UIC    no. 103  I 

■'    End   of    interrupt    vector    area    has    been    set    to    400 

i 

f 

>  Create  Executive  build  files 
f 

FIF'  RSXHC.MAC  =  SY!RSXMCO.MAC/AP 

>  ASN  sy:=lb: 

PREVIOUS  LOGICAL  NAME  ASSIGNMENT  REPLACED 

« 

!  Start  of  Executive  asseablii  at  13!09!11  on  19-APR-1982  | 

r 

:  SET  UIC  C10r243  ■ 

MAC  eSY!RSXASM 
f 
I  End  of  Executive  assetiblw  at  13:22!22  on  19-APR-1982  | 

f 

i    Start  of  device  drivers  assaablw  at  13!22:23  on  19-APR-1982  | 

f 

>  MAC  (?sy:rsxdrvasm 

f    End  of  Device  drivers  3sse»blw  at  13:29:37  on  19-APR-1982  | 

9 

>  asn=lb: 

r 

F  Prepare  for  task  buildind 
f 

>  SET  UIC  t3.243  | 

>  PIP  RSX11S.0BS=C10>241«.0BJ 

>  PIP  TTDRV.0BJ-C10»24]«.TTY 

>  LBR  RSX11S/CR:100.!960.!128.»RSX11S.0BS 
:>  LBR  TTDRV/CR!30.  :256.  :A4,»TTDRV 

:>  PIP  /NV  =  ClOf  103RSXBLD.CMD 

>  PIP    ClOf  103RSXBLD.CMDK/DF./NM 
i 

i    Clean-up  extraneous  obJact  files 
i 

>  PIP   RSXllS.0BSt«/DE/NHrTTnRV.0BJI»>C10>243«.OBJ)«i».TTYtt 
» 

i 

t    End  of  IISOEN  phase  I  at  13:31i26  on  19-APR-19e2  I 

»     —  To  coniinua  iwpe:  QC2r200}t 1S0EN2 


7-15  May  1982 


SYSTEM  GENERATION  ON  A  VAX/VMS  HOST 


SET  UIC  C2f200] 


eilSDtN2 

RSX-llS  Version  4.0  Bl  3?  Ssst**  Ovnvration  Phufi*  II 


Cop«riaht  (C)  1975>  1981 

Diaital    Eauip»erit    Corf-.f    Mst^nardr    HA. 

All  Rl9hts  Reserved. 


01754 


Build  The  Executive  And  All  Reouired  Tovk.* 

This  conikand  file  will  produce  the  target  svsie*  on  wour  SYt  divk. 
If  it  IS  an    RKOS  or  an  RL01>  this  coaaand  file  will  delete  a  nuMber 
of  files  fron  this  disk  to  Make  rooM  for  those  reauired  to  complete 
this  MSOEN.   You  Must  be  runninii  on  an  exr-andable  cofH   of 
your  disk.   Note  however,  that  the  disk  will  be  left  in  a 
state  such  thrtt  RSX-llS  SYSGENs  mitH    be  perforMMd  at  a  later 
date.   In  addition,  the  SYSGEN  itself  Maw  be  teminated  and 
nay  he  restarted  at  Just  .^bout  ijn<«  point  to  rebuild  par- 
t]culsr  Pieces  of  the  sustei). 

UN  UHAT  UIC  IS  SGNPARM.CMD  IF  NOT  C7t200]  CS3J 
Big  ditil-  distribution  kit  IISGEN  version  1.53  for  RSX-ltH  BL32 


198 
r  ? 


rec 
riKV 
AUL 

:^s 
:=s 
:=L 

!=L 
=  TK 
=  MP 

:C3 
:c3 

N 

=  L 


13!32:29 

] 

ru  alreadvi 

E  NAME  CSll 

Dii: 


e.-^ists 
DHi: 


;  Conlir.Msiioii  froi.  llSGEN  PHASE  I  done  on  19-APR-iye?  at  13:31:24 

TIM 

1?- 

UFIi 
IIFli 
*TARC 

SET 

ASN 

ASN 

A^N 

ASN 

ASN 

ASN 

ASN 

ASN 

SET 
:  ASN 


APR- 

sy: 

di 
*GFT 
DEF 

DMl 
[IHI 
PMl 
[I  Mr 
TK.  : 
mf: 

DMl 
BMl 
NOO 

sy: 


4niMTKB.TSK  =  TKB 
4311MyMR.TSK=VMR 


}  Eitpanded  coiments  provide  a  complete  description  of  everw  »tep  in 
i    this  IISGEN  coneand  file.   On  the  other  handi  short  coAMents 
i    provide  virtually  no  explanatory  text. 
» 

>«D0  YOU  WANT  EXPANDED  COMMENTS?  CY/N3:  Y 

f 

i    Create  RSX-llS  subset  s><steM  librarw 

)  if  von    have  not  already  done  so. 

>  SET  UIC  t3fl3 

♦HAVE  YOU  ALREADY  CREATED  USl IB.OLB?  CY/NJl 

>  LBR  l.B:ilSLIB/CR:30.:89i4.:320. 

>«HAVE  YOU  ALREADY  BUILT  THE  EXEC?  CV/N3: 

>  SET  UIC  C3.243 

i 

i    Pursle  Exec  build  coaaand  file*  and  asseablw  prefix  filet 
i 

>  PIP  RSXBLD.CHD/PU/NM 

>  PIP  ClOf 103RSXMC.HAC/PU/NH 
t 
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Now  wc  build  th»  Rxvcutiv* 
<  If  vou  Kusi  nak*  ch«n<*s  to  th*  EKvrutiv*  build  fil»s 
(  answer  we«  to  th*  following  ouvvtion.   Edit  R8XBl.D>CHD 
i    bw  issuin*  th«  co«M«nd  CDI  LDt RSXBLD.CHD.  U80EN2  will 
i  build  Ih*  F::<*cijt,ive  aftffr  <<qu  ri!>»ua*  fro*  th*  pau»*. 
( 
:«D0  YOU  UISH  TO  EDIT  THE  EXECUTIVE  BUIl.D  FILE?  [Y/N]: 

>  TKB  9LB*RSXBLri 

•Din  THE  EXECUTIVE  BUILD  SUCCESSFUl LY?  CY/NJ:  Y 
;  SET  UIC  C3rA43 

V«DO  YOU  WANT  TO  BUILD  ANY  LOADABLE  DRIVERS  N0U7  CY/NIS  Y 
i 
i    Build  Loadable  drivers 

«3.  DEVICE  FOR  DRIVER'S  HAPS  CD:  NL : 3  CS]: 

>  SET  UIC  C3f243 

V 

*  Thc>  following  «re  Mnenonics  of  the  loadabl*  devic*  dri v»r«  «el»ct»d* 

r 

«      DK     DL     DM     HH 
» 

i    When  all  drivers  are  builli  strik*  carriafle  return« 

i 

::«S.  DRIVER  2-CHARACTER  DEVICE  HNEHONIC  CS3:  DK 
:*6.  DRIVE  PARTITION  NAHE  CD:  DRVPARl  CSi: 

TKR  0SY*DKDRVBLb 
-«5.  DRIVER  2-CHARACTER  DEVICE  HNEHONIC  CS];  DL 
;»4.  DRIVE  PARTITION  NAME  CD;  DRVPAR3  T.Sll 

>  TKP  eSY;DLDRVBLD 

:«f<.  DRIVER  2-CHARACTER  DEVICE  HNEHONIC  CS3:  DH 
«6.  DRIVE  PARTITION  NAME  CD:  DRVPAR3  CS3: 

>  TKB  BSYtDHDRVLBD 

«5.  DRIVER  2-CHARACTER  DEVICE  HNEHONIC  CS3;  HH 
*6.    DRIVE  PARTITION  NAME  CD:  fjRVPAR3  CS3: 
TKE  eSVtMMDRVBLD 
:«5.  DRIVER  2-CHARACTER  DEVICE  HNEHONIC  CS3: 

>  SET    UIC    C3.64  3 

:;   sn   iiic  C3.243 

f    Yqij   now    need    the    Executive   aaps    to    lawout 
i    the    Partitions    in    wour   new    s<<s't«tt> 

i 

>«Dn  YOU  HAVE  THE  HAPS  ALREADY?  CY/N3: 

>  PIP  LP:=C3f343RSXllS.HAPtEXC0Nl.HAP>EXC0H2.HAP 
i 

i  Look  in  the  Map  cf  the  Exec  for  th*  svabol  'tSYTOP*  w:>ich 

i  indicates  the  last  address  allocated  to  th*  Ex«c.   liter 

i  partitions  na'^  start  at  *nw  location  bewond  this  address 

i  as  lon«i  as  thew  fall  on  a  64  bwt*  boundary.   See  th*  R8X-11H 

(  SYSGEN  Manual  for  a  dascription  of  how  to  set  up  p^'titionst 

^  You  Ma<i<  wish  to  stop  at  this  tiM«  to  lawout  wour  p  >■  ,ltions> 

F 

>«HAVE  YOU  ALREADY  BUILT  THE  FULL  DUPLEX  ^ERHINAL  DRIVER?  CY/N3: 

t 

(  Now  w*  build  th*  full  duplex  terainal  driver 

) 

I 

i    Th*  task  build  coaaand  fil*  for  th*  full  duplex  terainal  driv* 

i    sp*cifi*s  that  it  run  in  partition  TTPARt  having  ■  l»n«th  of 

>  40000  octal. 
I 

>«D0  YOU  UISH  TO  EDIT  THE  BUILD  COHNAND  FILE  FOR  THE  TERHINAL  DRIVER?  CY/N3t 

>  TKB  •lb:ttdrvbld.chd 

>«DID  THE  TERMINAL  DRIVER  BUILD  8UCCF.88FULLY?  CY/N3:  Y 
>*LI8T  FULL  DUPLEX  TERMINAL  DRIVER  NAP?  CY/N3t  Y 

>  PIP  LPt-C3f343TTDRV.NAP 
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«D0  YOU  WANT  in  CONTINUE  AND  BUII.D  THE  PRIUILEQED  TASKS?  CY/Ni:  Y 

F'repsi-e  to  assenbl*  and  build  ih*  RSX-llS  privil»!l»d 
software  coikponents. 

The  tasks  TKTNi  BASHCRf  OTL i  and  SIP  Must  ha  asseabledt  and  the 

ta<ik  build  cotiMand  files  possibly  edited  before  thew  can  be  built> 

The  tasks  RSDVOSf  RSDV/S2.  and  RSDVIH  need  on]«<  to  be  huiltf  but 

their  coiii»an<i  files  mn"^    also  be  edited  before  thew  are  built. 

It  IS  not  necessary  to  save/print  the  a^seablv  listinMsi 

Hoi>'evi>rr    we    recoeikand    thttt    yoi.i    save/print    the    task    build 

napf^.   This  is  espcciall^^  inportant  when  tfeneratinU 

an    uriw^^pF-ed  systeM  --  without  kaps  it  will  be  difficult 

*.o  rJeternine  partition  linitst 


♦ASSEMBLY  LIST  HEVICE  FOR  PRIVILEGED  TASKS  (DDNN:)  CD:  NL : 1  CS3: 
♦MAP  nE^irE  FOR  PRIVILFGFD  TASKS  (ODNNM  rO!  SY ! 3  rSJ: 
»HA<.'E  YOU  ALREADY  BUILT  TASK  TKTN7  CY/ND: 

Task  TKTN  will  be  included  in  your  US  sysie*  as  a  result 
of  vidur  selection  m  llSGtN  Phase  I. 


Thp  privileged  tasks  BASMCRf  OTL«  and  SIP  were  specially  designed 
for  use  m  the  RSX-llS  environeent.   Their  inclusion  in  the  syste* 
is  optional.   If  desired*  they  will  be  assembled  and  built  under 
control  of  this  coam^tid  file. 

♦no  YOU  WISH  TO  INCLUDE  BASMCRr  CTLi  OR  SIP  IN  YOUR  SYSTEM?  CY/Ni:  Y 

The  tasks  RSDVOSt  RSDVS2t  and  RSDVIH  dwnaaically  display 
ilie  status  of  menory  on  a  araphi(?s  terainal  and  can  be  built 
for  the  VT05B  terdinalt  VT5?  terainal >  and  VTIOO  terminal 
resf'Brt  i  vpI  s .   These  tasks  display  which  tasks  are  in  aeMOry 
^iid  where  in  neiiory  they  reside?  which  task  is  currently 
runriinl'  and  the  status  of  pool. 

«D0  YCU  WANT  TO  INCLUDE  RSDVOf..  RSDV53f  OR  RSDVIH?  CY/NJ; 

The  RSX-llS  subset  file  control  services  (PCS)  are  dist- 
aodules.   They  cannot  be  placed  in  the  RSX-llH  systea  object 
library  (SYSLIB . OLB) .   Howevert  users  who  reauire  this  PCS 
should  link  with  the  RSX-llS  subset  of  SYSLIB  (IISLIB.OLB) 
created  durind  this  SYSOEN. 

»D0  YOU  WISH  TO  INCLUDE  THE  RSX-llS  SUBSET  PCS?  CY/N3:  Y 

The  RSX-llM  crash  duap  analyzer  (CDA> 
aay  also  be  built  to  run  nn  a  non-H 
host  systea  for  analysis  of  RSX-liS 
crash  duaps. 

«D0  YOU  WISH  TO  BUILD  CDA  POR  YOUR  HOST  SYSTEM?  CY/N3:  Y 
SET  UIC  ClOrlO] 

>  UPD  sy:cioi10d 

UPD  --  directory  already  exists 

:>«D0  YOU  UISH  TO  HAKE  CORRECTIONS  TO  RSX-U8  SOURCE  MODULES?  CY/N3: 


SET  UIC  C3t243 

MAC  ffTKNASM 

PIP  TKNASM.CMDtt/DE 


The  task  build  coaaand  file  for  TKTN  specif i«m  thai  it  run  in 
partition  SY8PAR>  havinfl  a  lenHth  of  3700  ociel. 
If  you  aust  chanrie  the  partition  naae  or  l«n«iht 

>  wou  Mill  have  to  sdit  its  task  build  coa»«nd  fil*» 

I 
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«D0  YOU  HAVE  TO  EDIT  THE  TASK  BUIl.O  COHHANO  FILE  FOR  TKTN?  CY/N3: 

>  TKB  9TKN11SFILD.CHD 
i 

{    PASMCR  is  a  privil*«*d  ta»k  which  supplies  «  sohnrt  <or  bA«ic 
J  set)  of  the  RSX-llM  MCR  coMiiands.   It  cannot  >>•  iMclij<.1ffii  if 
i    durina  SYSCEN  Phase  I  vou  indicated  that  wou  did  not  want  anw 

>  terminal  devices.   Its  size«  depending  upon  optiono  ranges 
r  froii  6400  to  14000  octal  on  napped  susiens. 

f 

:  *riO  YOU  WANT  TO  INCLUDE  TASK  BASMCR?  CY/Ni:  Y 

;  UFD  SY:ClAft03 

;  UFD  SY!C16f243 

::  SET  UIC  Ct6fl03 

;  FIF  eMPRE.MAC?«/DE/NM 

;  FTP  «.MACJ«/RM/NM 

>  PIP  C16.«]«.«5«/DE/NH 

PIP'  C16.101  =  C2.20]BMPRE.HAC 

FTP  C16.  10]/EN=C2r20]AB0BAS.HACiATLBASiBRKElAS>ERRBAS»ERRHS6 
:  PIP  C16»t03/FN=C2»203FMTDV.HAC.FN0IJCBf6NBLK»GETNUM»KEYWD 
PIF  C16f 10]/EN=C2f203LKLST,HACiMCRBAS»0PEBASiPRSBASiREnBAS 

>  PIF  C16f  10]/EN  =  C2f20.1REHBAS.HACfRPSBAS»RIJNBASiTIHBAS 
:  SFT  UIC  C16.24D 

i 

•  The  size  of  BASIC  hw(\  is  dependent  UPon  the  inclusiori  of 

i  conditional  assembly  code.   The  inclusron  of  the  code  im 

i  rontrolled  bv<  st^ikbol  definitions  appearinst  in  an  assembly 

t  pref?:;  fjle.   The  'lefaijlt  for  these  conditionals  is 

i  eiiclusion.   The  following  optjonsi  alond  with  the  corre*- 


RtlATL  -  ATL/T 
R$iERM  -  ERROR 
R$»OPE  -  OPEN 


AL  COMHANDS 

MESSAGE  TEXT 
COHHAND 


To  include  an  option 
and  remove  the  semic 
e ; ;  (5  »  p  1  e  ! 

«PL  JR««ATL 

;r»«atl  =  0 

«C  /}// 
R»$AT1  =  0 


locate  the  desired  conditional  symbol 
olun  at  the  befiinninsi  of  the  line.   For 


i INCLUDE  ATL 
i INCLUDE  ATL 


Rppeat    this    for    all 
appear    on    con<.ecijtiv 


desired  options.   Note  that  the  symbols 
e  lines  in  alphabetical  order  in  the  file. 


;«D0  YOU  UISH  TO  EDIT  THE  ASSEMBLY  PREFIX  FILE  FOR  BASHCR?  CY/ND:  Y 

>  EDI  Cl6»t03BMPRE.MAC 
C00029  LINES  READ  IN3 
CPAGE     13 

*PL  5R»»ATL 

SR»«ATL  =         0 

«C  /i// 

RttATL  =  0 

«FL  fR«)ERN 

fR«»ERM  =         0 

«C  /?// 

R»»ER«  =  0 

«FL  >R«»OPE 

iR»»OPE  =         0 

*C  /i// 

Rt«OPE  »  0 

«EXIT 

CEXIT3 

>  HAC  0BASHCRASH.CHD 

>  SET  UIC  C3.243 


t  INCLUDE  ATL 

;  INCLUDE  ATL 

f  INCLUDE  ERROR  MESSAGES 

t  INCLUDE  ERROR  MESSAGES 

t  INCLUDE  OPEN 

(  INCLUDE  OPEN 
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P\P    riA.tODUHP'RE.HACIt/OC/MH 

F'lF     C16t  10]«.HAC«t/KH/NM 

F'lF'    BASNCR.Od  J'[16f  241«.0kJ 

F  IF'    C16>24]*.*S«/DE/MH 

Ihk    HASHrR/CFc:?!  .  :64.  :44.-BASNCR 

FIF-    BASMCR  .OIiJ!»/PE/NH 

Thp    tes»     t><jil<l   coMMand    fil*    for    BASHCR    •^vcifir*    that    it 
r>jr.    in    partition    HCRPARt     l»n<«.h    t4000    oct-il     (Mappffd). 
If    vo'j    Mutt    Chans*    th»   partition   na**    or    )vn4tht 
Mo<j    will    haw    to    »<jit    itt    \.»%V    build    co»»and    fil*. 


«[iO    YOU    WISH    TO    EDIT 
TK6    PBASMCRfil  O.CHr 


THE    TASK    BUILD    CnHHAND    FIIE    FOR    BASNCK''    CY/N]: 


QTi.    1%    a    F-rivileaed    ta«F    which    i«    th*   RSX-llS   on-lini»    ia«k    lo.idvrt 
li    f-erforms    th»    iri<^tall>     loadf    and    tiy.    function*    for    ta«l<.«    which 
were    crealed    ori    a    ho«t    dvv«lop»*rit    awstcM    and    copied    via    FIX    to    a 
In^ij    neriiijik,       de^endi  :'i9    on    tha    nuahwr    of    load    d»vir»«»    ptr»    OTL 
I  drides    frok    8000    to    If'OOO    octal    on    kappvd    tyctras. 


UF 
UF" 
3E 
F  I 
FI 
fl 
FT 
f  I 
F  I 
SF 


YOU 

D  sy: 
II  sy; 

T    UTC 

f  sy: 
F  sv: 
F'  t  ::o 

F  tl'O 
F      [?0 

F  r?o 
1   uic 


WANT 

cro.  I 

[?0.2 

l20 
OTLPR 
«HAC; 
.*!«. 
.10  3- 
.101/ 
.  103  ' 
C?0 


INfl  UriF     TASK    OTL'    [Y/N!     V 


1 

MAC;«/DF/NM 

RM/NM 

«    DE  'NM 

.rOlOTLFRE.HAC 

^C2.?0  30TL.MAr.OTLCD.OTLCMiOTLERR 

=  C2.20  30TLHD.MAC.OTLl  B.OTLl D .OTl QIOrOTLRD 

3 


i  'fhv    sire  of  OTL  is  dependent  upon  the  inclusion  of  conditional 

f  ass^eniblH  co^Ip.   The  incluston  of  the  cods  is  don«  in  two  w«<<s« 

•  ti>^  a  single  sviibol  defiratiori  and  bv  Macro  rails  appearing 

i  m  at,    4s-sei»bls  i^refi:;  file.   The  first  controls  the  inclijsion 

i  of  error  iiiessc^se  text.   To  include  this  optionf  locate  the 

•  i:ifl<h'  1  R'ttFR'H.  ari'i  reaove  the  seaicolon  fro*  the  be4innind 

f  of  I'le  line.   The  default  for  error  Message  text  is  exclusion. 

;  For  e:aiiiple: 


8  «FL  SRStERM 

I  tR«SERH=0 

»  «C  /5// 

I  R«SERM=0 

T^lp  other  t<^pe  of  option  concerns  the  exclusion  of  unwanted 
device  support.   For  each  of  the  OTL  load  devices  which 
were  included  in  SYSGEN  Phase  I*  corresponding  support  will  be 
denerateii  in  Oil..   Naturallw>  support  will  not  b«  venerated  ^or 
those  OTL  load  devices  which  were  not  included  in  SYSGEN  Phase  I. 
The  following  devices  along  with  corresponding  control  s.<Mbols 
ma<d   be  supported  bv  OILS 

PRll  -  PAPER  TAPE  READER PR 

RXll  -  RXll  FLEXIBLE  DISK  DX 

RX21  -  RX211  FLEXIBLE  DISK  DV 

TAtl  -  CASSETTE  TAPE CT 

TCn  -  DECTAPE DT 

TMll  -  TM/THA/THBll  HAGTAPE  MT 

TSll  -  TS04  HAGTAPE MS 

TU16    -    TJ/THIJ16-45   HAGTAPE MM 

TU5B    -    TU58   CARTRIDGE DD 


t    To   fxcl'jde   OTL   support   for   ■  device  Mhich  has  Dean  rienaratvd   Into 
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t    40<jr    RSX-llS    ExK-'utivef    local*    th*    corrffs^ondinM   device    ««Mbol 

i  and  place  a  seaicolon  at  the  beMinnina  of  the  linei   For  exaapIeS 

t 

(        tF'L  PRll 

I  INCLUD  PR11>P««R11      IPCll/PRll  SUPPORT 

f        »C  //»/ 

f  »  INCLUD    PRll.P«$Rn  IPCll/PRU    SUPPPRT 

)  * 

t 

Perfom  this  for  all  of  the  above  device*  which  will  be  part  of 
«otjr  RSX-llS  E:;eciitivi»t  but  for  which  wou  <.1o  not  want  OTL 
support.   Note  that  the  >v»bol«  appear  on  consecutive  line?  in 
alphabetical  order  in  the  file. 

«tiO  YOU  WISH  TO  EDIT  THE  ASSFHBLY  PREFIX  FTIE  FOR  OTl  '  CY/NJ!  Y 
EIU  C20f  lOlOTl.PRE.MAC 
C00141  LINES  READ  INI 
Cr-AGE     n 
*IL  JR»»ERM 
»R«$FRM=0 

»(:  ,'!/■• 

Rt»ERM-0 

*«.xir 

CEXIT 1 

MAC  eOTLASH.CMD 
:  3FT  DTC  n.?43 

rip  C20. 1010TLFRE.MAC»«/DF/NM 

PIP  CJOf 101».MAC5»/RH/NM 

flP  0TL.0BJ=C20t24]».CBJ 

PIP  [rO.?4]*.«i*/nE/NM 

I  BR  0TL/CR:21 . : 128. ;64.=0TL 

LBR  rm^r2»20]Bl.XI0M 

(TP  OTL.OBJJ»/IiE/NH 

1he  tas^  build  comnand  file  for  OTL  specifies  that  it 
run  in  partition  OTLPAR>  length  ISOOO  octal  (aapped). 
If  uou  must  change  the  p-artition  naae  or  lengthi 
vou  will  hav<>  to  edit  its  task  build  cokeand  file. 

«D0  YOU  WISH  TO  EDIT  THE  TASK  BUILD  COHHAND  FILE  FOR  OTL?  CY/Ni: 
TKB  eOTLBLD.CHD 

SIP  is  a  privileged  task  which  performs  the  RSX-llS  s>4»ieM 
iikaae  preservation  duties.   It  replaces  the  RSX-1;H  3AV  HCR 
coMnand.   Depending  on  the  number  of  load  devicesr  etct  SIP 
ranges  fro»  3700  to  7400  octal  on  aapped  svsteas. 

i 

:  «DP  YOU  WANT  TO  INCLUDE  TASK  SIP7  CY/Ni:  Y 

>  UFD  SY;C21.10] 
::  UFD  SY:C21.24] 

>  SET  UIC  C21.103 

>  PIP  sy:sippre.mac»«/de/nh 

>  PIP  sy:«.iiac»»/rm/nh 

>  PIP  C21.«3«.«»«/DE/MM 

>  PIP  C21f 10]-C2f20]SIPPRE.HAC 

>  PIP  C21>10]/EN-C2F20]SIP.HACfSIPB00iSIPCDfSTPrRR 

>  PIP  C21it01/EN-C2r20]STPLD.HACrSIPQI0 

>  SET  UIC  C21f243 
> 

I  The  size  of  SIP  is  dependent  upon  conditional  asueMblw  code 

I  in  cxactlv  the  gaaa  Manner  as  OTL.   There  are  onlM  a  few  ainor 

i  differences.   OTL  supports  the  paper  tape  reader  using  the 

t  control  swabol  PRllI  SIP  on  the  other  hand  supports  the  paper 

t  tape  punch  using  the  control  swabol  PPll.   In  addition?  OTL 

I  supports  DECtape  II  cartridges  using  control  swabol  TUS8  end 

I  T811  Magnetic  tape  drives  uftng  the  control  swabol  T811. 
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i    Edit    SIFPRE.HAC    in    th»    •••••   w«w    d*«crib*d    for    Ofl..    For    txaa^l*: 

f 

i  «fL  r-Fll 

INCLUIl  PFllrF-ttPll      IPCll/PRll  SUPPORT 
i  «C  //»/ 

«         »  INCLUD  PPllfP««Pll      »PC11/PR11  SUPPPRT 

i        » 

i  «D0  YOU  UISH  TO  EDIT  THE  ASStHBLY  PREFIX  FILE  FOR  SIP'  CY/N3:  Y 

EM  C21.10DSIPPRE.MAC 
100080  LINES  READ  IN] 
tPAGE     1] 
«l L  ;R«tFRn 
tR$»ERM=0 
♦c  /;/  ■ 
f(«»EFrt  0 
»tvil 
I  I  X  I  T  1 

MAC  f?SIPASH.CMD 

•F  r  UIC  rT,24] 

(  ](•  I  31.10:SIPPRE.MAC;«/DF/NM 

FIP  C:?lf  101».HACS»/RM/NM 

FIP  SIP.OBJ=C2Jt243«.OBJ 

FIF  C:i .?41«.«S»/0E/NM 

I  PiK  SIF/CR:20.  :64.  :64,=SIP 

FIF  S1P.06JS«/DE/NM 

Ihe  tasF  huild  coanand  fil»  for  SIP  specifics  that  it 
run  >.-■  f-artitiori  SIPPARf  length  /400  octal  (•8Pf*d). 
If  Hon    must  ch«ng»  the  partition  n«M*  or  lenithr 
^ou  will  have  to  edit  its  task  build  cokMand  file. 

♦  no  >0U  WISH  TO  EDIT  THE  TASK  BUILD  COMMAND  FILE  FOR  SIP'  CY/NJ*. 
1KB  PSIPBLIi.CMD 
SFT  UIC  t3»24D 
» 
i     It  nau  be  necessary  to  edit  the  task  build  coakand  file  and  ODl  file 

>  to  bijild  CDA  for  tlie  non-M  host.   Chan4e  the  partition  naa*  and 

i  base  address  to  Match  that  of  the  partition  (on  the  host  svistea)  into 
t  whirh  CDA  will  be  installed.   You  will  .tlso  need  to  change  the  ODL 
;  file  to  reference  the  correct  device  on  the  host  where  SVSl.IB  and 
i    EXELIB  reside.   The  files  are  n^iied  CDABLD.CMO  and  CDABLD.OOL. 
i    Ue  will  now  piuse  to  allow  aou  to  edit  the  coM*and  files. 
»  11SGEN2  --  Psiislnq.   To  continue  tspe  'CONTINUE'. 

>  CONTINUE 

i    11SGEN2  --  continuina 
SET  UIC  C3.64J 

>  TKB  eC3t24DCDABLD 

J  The    CDA.TSK    file    resides    in    C3.&4]    on   »iour   RSX-llS    svsilen    disk 

i  and  can  be  run  on  the  host  swstea. 

5  CDA  Must  be  run  in  coMPat ibi 1 i tw  Mod*  on  VAX/VMS  hosts. 

:  SET  UIC  C3f243 

I 

)  Add  subset  FCS  to  the  RSX-llS  swsteM  object  librarw. 

:  SET  UIC  C3il3 

LBR  LB:ilSLie/RP-C2t20]FCSllS 

>  PIP  lb:iislib.olb/pu/nh 
I 

t    Support  for  ih«  Set  Tiae  directive  wes  chosen  in 

>  SYSGEN  Phase  I.   Produce  the  8ETTIH  obJect  Module. 
> 

>  SET  UIC  C3i24] 

>  HAG  tSETTIHASH 
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>  PIP  8ETTIHA8H.CNDt«/DE 

>  SET  UIC  C3tA4] 
PIP  ».«/PU/NH 

PIP  C3>24]*.«/PU/NN 

The  opttration  left  to  b*  PTi'^rmm^    i«  that  of  th»  final 
configuration  of  the  virgin  a^acutiva  uaina  Virtual  NCR. 

«D0  YOU  UANT  TO  CONFIGURE  THE  EXEC  AT  THIS  TINF  USING  VHR-*  CY/Ni:  Y 

Tha  contants  of  Mour  RSX-llS  ralaata  fc.it  currantly  rasidas 
undar  tha  UFD  C2r201.   If  wour  SY*.  disk  i«  not  «n  RK0A/C7  or  an 
RP04/05/06  wou  aaw  want  to  d«>lata  tha«a  fila«.   Lravina 
thaa  on  tha  disk  will  s»vw    th«  tiaa  of  ra-co^vinfl  thaa  tha  naxt 
tiMa  wou  parfora  an  RSX-llS  Swaaan.   If  vour  SYS  diak  xi,    an  RKOSt 
thaw  will  ba  autoaaticalls  dalatad. 

•DO  YOU  WANT  TO  DELETE  THE  RSX-llS  KIT  FROH  THIS  DISK?  CY/Ni: 

Ua  will  now  iiaka  a    copw  of  uour  taraat  swctaa 

F-IP  RSXllS.SYS/NV/CO/Bl  :498.=RSXnS.TSK 

If  \iOKi   wish  to  aafce  a  cop»  of  Mour  task  or  swstaa  laaae  file 
on  anothar  d«vica  wa  will  pausa  to  allow  wou  to  ilo  •io. 

«D0  YOU  UISH  TO  COPY  YOUR  SYSTEM  TO  ANOTHER  DEVICE'  CY/Ni: 

RSXllS.TSK  is  a  backuF  copv  of  tha  US  svstaa  mou  hf>  a  just  built. 
If  sou  do  not  wish  to  retain  itr  we  will  <1elete  it  ik  w. 

«IiO  YOU  UISH  TO  DELETE  THE  SYSTEH  BACKUP  FIIE  RSXllS.TPK'  CY/Nl*. 

Your  target  SMStaa  is  now  read\<  to  sat  up  ^artit^.ons  and  install 
the  reoijir<»d  t4sks>   The  procedure  to  follow  is! 

1)  Run  Virtual  HCR 

2)  Extend  F'OOl  space  to  base  of  first  partition 

3)  Set  UP  «our  partitions 
3B)  Load  needed  drivers 

3C)  S&t  UP  4  Partition  for  the  Directive  Coaaon 
4>  Install  tasks  (BASHCRi  OTL>  SIP>  TKTN) 

5)  Fi;:  tasks  into  (virtual)  aeikor^ 

6)  Optionallw  set  the  tiae  and  save  a  copu  of  TH£ 
siiistRih  on  a  bootable  avdiu* 

7)  Exit  froa  virtual  NCR  and  boot  in  «our  taraet  svstea 

VhR  e:Ha»Ple: 

>VHR  !  RUN  VIRTUAL  NCR 

ENTER  FlI.ENAMEiRSXllS.SYS   !  VMR  PROHPTS  FOR  FILE  NAME 

VMR>SET  /POOL=XXX        !  EXTEND  POOL  TO  FIRST  PARTITION  BASE 

VMR>SET  /MAIN=TTPAR!XXX:XXX:TASK   !SET  up  FULL  DUPLEX  TT  PARTITION 

VMR>SET  /MAIN»DRVPAR!XXX:XXX;TASK   (  SFT  UP  DRIVER  PARTITION 

VMR>SFT  /MAlN=EXCnMi:XXX:XXX!COM   i  SET  1ST  EXEC.  COMMON 

VMR>INS  EXCOMl  (INSTALL  1ST  EXECUTIVF  COMMON 

VMR>SFT  /MAIN=tXCOM2!XXX:xXX:C0M   '  SET  2ND  EXEC.  COMMON 

VMR>INS  EXC0M2  ! INSTALL  2ND  EXECUTIVE  COMMON 

VMR'SET  /MAIN=SYSPAR:XXX!XXX!TASK   •  SET  UP  TKTN  PARTITION 

VMR>SET  /MAIN=MCRPAR!XXX:XXX:TASK   •  SET  UP  MCR  PARTITION 

VMR>SET  /main-=otlpar:xxx:xxx:task  i  set  up  otl  partition 

VMR:SET  /MAIN-SIPPAR: XXX : XXX: TASK   !  SET  UP  SIP  PARTITION 
VMR>SFT  /MAIN=GEM:XXX!XXX:SYS   •  IF  SYSTEM  CONTROLLKD  PAR. 

VMR>SET  /main=gen:xxx:xxx:task  i  if  user  controlled  partition 

VMR>LOA  XX!  !  LOAD  XXDRV 

VMR>INS  TKN  •  INSTALL  TASK  TERMINATION  TASK 

VMR>FIX  TKTN  •  FIX  INTO  MEMORY 
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VHR>IN8  BA8HCR 

VNR>FIX  NCR... 

VNR>IN8  OTL 

VHR>FIX  OTL 

VNR>IN8  SIP 

VRH>FIX  SIP 

VHR>TIH  lOMS  11/10/77 

VHR>SAV  OXtRSXllS 

WMR>"Z 

End  of  VHR  •Ktapl* 


INSTALL  BASIC  NCR 

FIX  INTO  NENORY 

INSTALL  ONLINE  fASK  LOADER 

FIX  INTO  NENORY 

INSTALL  SYSTEN  PRESERVATION  TASK 

FIX  INTO  NENORY 

SET  TINE  AND  DATE 

SAVE  SYSTEN  ON  RXOl  FLOPPY 


(  EXIT  FRON  VIRTUAL  NCR 


Mow  A*   will  run  Virtual  NCR  «o  that  wou  aaw  initialize 
wour  swstsM.   B«  sur*  to  dafin*  all  raouirad  partitions 
at  this  ti«ar  bacausa  thv  Sf.'T  function  is  not  su^^ortad 
in  RSX-llS  BASIC  NCR.   Furtharaorar  if  sou  i»lan  to 
include  BASIC  NCR  and  OTL  in  Mour  S4staa>  .haw  aust 
ba  installed  and  fixed  into  aenorw.   Other  t«sks« 
such  as  SIP  and  tkTN  aaw  be  loaded  into  a  running 
RSX-llS  swstea  usina  OTL. 

note:  Since  LOAD  and  UNLOAD  are  not  supported  on 
a  runnina  RSX-llS  <iwstea>  all  r>>auir*d  load<ibla 
drivers  aust  be  loaded  using  VNR. 

note:  You  have  reauested  to  include  the 
directive  cooiaon<   You  aust  install  the 
coiiMon  prior  to  e>.itin<  Virtual  HCR 
or  sour  RSX-llS  ssstea  will  not  boot. 


:  VMR 
tnter  f 

vmr::set 

VMR; SET 
VMR  LOA 
VNR^SET 
VHR;  LOA 
VMR- LOA 
VhR:  LOA 
yriR  LOA 
VMR  SfT 
VMR  -- 
VMR > SET 
VMR > INS 
VMR  -- 
VMR>SET 
VMR; INS 
VMR  -- 
VMR :  SET 
VMR>SET 
VMR > SET 
VMR>SET 
VMR; SET 
VMR>INS 
VMR>FIX 
VMR: INS 
VMR  FIX 
VMR > INS 
VMR>FIX 
VMR: INS 
VMR  FIX 
VMR: "Z 


ilenaae:  RSXllS 
/PQOL=* 

/main=ttpar:«: 162: TASK 

tt: 

/main=drvpar!»:»:sys 

dk: 

dl: 

dm: 

mm: 

/top=drvpar:-« 

»DIAG»-Installed  tasks  aas 

/MAIN°EXCOMi:*:2O0:C0M 

EXCOMl 
•DIAGt-Partition  reduced  to  executive  coeaon  size 

.  MAIN=EXC0M2:«:200:C0M 

EXC0M2 
«DIAG*-Partition  reduced 

/main=syspar:«:37:task 
/main=mcrpar : « : 140 : task 

/MAIN=OTl PAR :«:i50: TASK 

/main=sippar:«:74:task 
/MAiN=GftN:«:»:sYS 

TKN 

TKTN 

BASHCR 

MCR. . . 

OTL 

OTL 

SIP 

SIP 


rio    longer    fit    in   (Partition 


to  enecutivp  cnaaon  size 


i    Uhen  this  coaaand  file  coai»latest  wour  RSX-llS  swstea  is 
I  reads  to  run. 
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» 

>  SET  UIC  C2f2003 

>  TIM 

19-APR-19B2  14tl7tl0 
I 

>  ALL  NTOS 
.HTAOt  ALLOCATED 

>  NOU  NTOt/FOR 
XHOUNTED-I-HOUNTEDi  aountvd  on  .HTAO: 

>  FLX  MTOt/ZE 

>  SFT  UIC  C3t«4] 

>  VHR 

Eni«r  ti\mn»m»i    R8X118 
WMR>TIH  19-APR-82  14100 
VHR>SAV  HTOtllS 
WHR>"Z 
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The  following  numeric  list  of  error  messages  is  a  subset  of  the 
RSX-llM  error  messages.   The  exact  message  format  is: 

XXX  ~  ft  -  ERROR  MESSAGE 

where  XXX  is  replaced  by  OTL,  SIP,  or  MCR  to  indicate  which  component 
issued  the  message.  This  list  omits  the  component  prefix  indicat  r  to 
make  a  numerical  search  easier  for  you. 

1  -   ILLEGAL  FUNCTION 

A  command  was  entered  that  MCR  cannot  recognize. 

2  -   SYNTAX  ERROR 

This  message  generally  indicates  that  the  required  information 
was  .jntered  with  improper  syntax.  Retype  the  command 
specification  using  the  correct  syntax. 

3  -   NO  POOL  SPACE 

Request  for  dynamic  memory  could  not  currently  be  satisfied  by 
the  Executive  or,  upon  issuing  an  I/O  request  or  attempting  to 
allocate  pool  space,  OTL  detected  a  condition  of  insufficient 
pool  space  in  the  Executive.  When  this  error  condition  occurs, 
OTL  may  exit  without  printing  this  error  message. 


4  -      INVALID   KEYWORD 

A  keyword  was  encountered  that 
specific  command  processor. 

5  -   DEVICE  NOT  IN  SYSTEM 


was  not  recognizable  by  the 


The  device  specified  in  the  command  was  not  generated  into  the 
system.  Devices  to  be  used  in  the  system  must  be  specified 
during  system  generation. 


6  -   PRIVILEGED  COMMAND 

A  command  that  is  available  only  to  privileged 
issued  from  a  nonprivileged  terminal. 


terminals  was 
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7  -   PARTITION  NOT  IN  SYSTEM 

The  partition  name  specified  as  an  argument  in  a  command  could 
not  be  found  in  the  system,  or  the  partition  specified  in  the 
task  image  was  not  defined  in  the  system.  Alternatively,  the 
specified  partition  was  defined,  but  all  or  part  of  its  memory 
was  not  present  in  the  current  configuration. 

8  -  10  ERROR 

In  attempting  to  read  the  next  command,  OPEN  detected  an  error; 
or  an  MCR  terminal-write  operation  failed;  or  a  hardware  error 
was  encountered  as  the  result  of  an  I/O  request  issued  to  the 
load  device  or  terminal;  or  the  specified  device  was  generated 
into  the  system,  but  it  was  not  present  in  the  hardware 
configuration. 

9  -   BYTE  ADDRESS 

The  <  "ress  specified  as  the  argument  to  the  OPEN  command  was  an 
odd  address. 

10  -  INVALID  TIME  PARAMETER 

A  time  field  was  incorrect. 

11  -  TASK  NOT  IN  SYSTEM 

The  referenced  task  was  not  installed  in  the  system. 

12  -  INVALID  ADDRESS 

The  address  specified  e  an  argument  in  the  OPEN  command 
referenced  a  nonexistent  memory  location  or  an  address  outside 
the  boundaries  of  the  specified  partition. 

13  -  TASK  NOT  ACTIVE 

The  specified  task  was  not  active. 

14  -  TASK  BEING  ABORTED 

A  request  for  the  execution  of  a  task  was  made,  but  the  task  was 
being  aborted  because  of  an  error  or  the  MCR  ABORT  command. 

15  -  TASK  NOT  SUSPENDED 

The  task  used  as  the  argument  of  the  RESUME  command  was  not 
suspended  at  the  time  the  command  was  Issued. 

16  -  TASK  ACTIVE 

The  task  used  as  the  argument  cf  the  command  was  active. 

17  -  CIRCULAR  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  a  device  in  such  a  way  that  a 
circulai  list  of  redirects  would  result. 

18  -  OLD  DEVICE  NOT  KNOWN  TO  SYSTEM 

An  attempt  was  made  to  redirect  an  unknoim  device  unit. 
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19  -   NEW   DEVICE   NOT    KNOWN   TO   SYSTEM 

The  new  device  in  the  REDIRECT  command  was  not  known  to  the 
system  (did  not  exist  in  the  device  tables). 

20  -  PSEUDO  DEVICE  REDIRECT  ERROR 

An  attempt  was  made  to  redirect  a  pseudo  device  to  another  pseudo 
device. 

21  -  OLD  DEVICE  ATTACHED 

An  attempt  was  made  to  redirect  an  attached  device  unit. 

22  -  TI  REDIRECT  ERROR 

The  pseudo  device  TI:   cannot  be  redirected. 

23  -  INVALID  UIC 

A  value  of  0  for  either  the  group  numbei  or  the  member  number  was 
detected . 

24  -  ILLEGAL  KEYWORD  VALL.E 

A  value  entered  for  a  keyword  exceeded  its  limits.  Enter  a  valid 
value. 

26  -  LISTING  DEVICE  NOT  AVAILABLE 

The  device  unit  to  which  MCR  was  attempting  to  display 
information  was  attached  and  therefore  unavailable  for  printed 
output. 

27  -  DEVICE  NOT  REDIRECTABLE 

The  specified  device  cannot  be  redirected. 

40  -  BASE  ADDRESS  MUST  BE  ON  A  4K  BOUNDARY 

A  task  image  (not  a  common  block)  in  a  mapped  system  specified  a 
base  address  not  on  a  4K  boundary. 

41  -    ILLEGAL    1ST   APR 

The  image  of  a  nonpr ivileged  task  in  a  mapped  system  specified  a 
nonzero  first  APR,  or  the  image  of  a  privileged  task  in  a  mapped 
system  specified  a  first  APR  that  was  not  in  the  range  APR4 
through  APR6. 

42  -  NOT  ENOUGH  APRS  FOR  TASK  IMAGE 

There  are  not  enough  APRs  to  map  the  task  and  all  resident 
library  references  it  may  have  in  a  mapped  system. 

43  -   FORMATTED  BINARY   CHECKSUM    ERROR 

A  checksum  error  was  encountered  while  reading  a  task  image  from 
paper  tape. 
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44  -  FORMATTED  BINARY  FORMAT  ERROR 

An  invalid  binary  format  was  encountered  in  a  task  image  being 
read  from  paper  tape. 

45  -  UNEXPECTED  END  OF  FILE  ENCOUNTERED 

An  end-of-file  was  encountered  before  the  entire  task   image  was 
read. 

46  -  SPECIFIED  PARTITION  TOO  SMALL 

The  partition  specified  in  the  task  image  was  smaller  than  the 
load  size  of  the  task  or  common  block. 

47  -  SPECIFIED  PARTITION  FOR  COMMON  BLOCK 

An  attempt  was  made  to  install  a  task  into  a  common  partition. 

48  -  TASK  IS  OVERLAID 

This  message  is  returned  by  two  conditions: 

1.  An  attempt  was  made  to   install   an  overlaid   task   in  a 
system  without  memory  management  directives. 

2.  An  attempt  was  made  to   install  a   task   that   has 
disk-resident  overlays. 

49  -  TASK  NAME  ALREADY  IN  USE 

An  attempt  was  made  to  install  a  task  with  the  same  namei  as  that 
of  a  task  already  installed. 

50  -  TASK  NAME  NOT  DEFINED 

An  attempt  was  made  to  install  a  task  from  paper  tape  without  an 

optional   file  name  specified,  and  the  task  image  did  not  contain 

a  task  name.  Reenter  the  command  line,  specifying  a  file  name 
that  will  become  the  task  name  by  default. 

51  -  TASK  AND  PARTITION  BASES  MISMATCH 

An  attempt  was  made  to  install  a  task  in  an  unmapped  system  whose 
base  address  did  not  match  that  of  its  specified  partition. 

52  -   INVALID  COMMON   BLOCK 

A  task  contained  a  library  reference  to  a  common  block  that  was 
not  in  the  system. 

53  -  PARTITION  TOO  LARGE  FOR  PRIVILEGED  TASK 

An  attempt  was  made  to  install  a  privileged  task  in  a  partition 
whose  size  was  greater  than  12K  words.  (This  message  occurs  only 
on  unmapped  systems.) 

54  -  FILE  NOT  FOUND 

The  specified  file  was  not  found. 
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55  -  COMMON  BLOCK  IS  TASK  PARTITION 

A  task  image  contained  a  library  reference  whose  name  matched 
that  of  a  task  partition. 

56  -  COMMON   BLOCK  NOT    LOADED 

A  task  image  contained  a  library  reference  to  a  common  partition 
that  was  not  loaded. 

57  -   LENGTH   MISMATCH  COMMON   BLOCK 

A  task  image  contained  a  library  reference  to  a  common  block  that 
was  smaller  than  the  size  specified  when  the  task  was  built. 

58  -   BASE   MISMATCH   COMMON   BLOCK 

A  task  image  contained  a  library  reference  to  a  common  block 
whose  base  address  was  different  from  the  one  specified  when  the 
task  was  built. 

59  -  COMMON  BLOCK  PARAMETER  MISMATCH 

A  task  image  contained  a  library  reference  to  a  common  block  that 
was  expected  'to  contain  position-independent  code,  but  that  did 
not;  or  a  task  image  contained  a  library  reference  to  a  common 
block  that  was  not  expected  to  contain  position-independent  code, 
but  that  did;  or  an  attempt  was  made  to  load  a  common  block 
whose  task  name  did  not  match  the  partition  name. 

60  -  PARTITION  NOT  COMMON 

An  attempt  was  made  to  install  a  common  block  in  a  task 
partition. 

61  -  ILLEGAL  DEVICE 

A  task  image  contained  a  LUN  assignment  to  a  device  not  in  the 
system. 

62  -  FILE  NOT  TASK  IMAGE 

Preliminary  checks  indicated  that  the  specified  file  was  not  a 
task  image  or  that  the  file  was  corrupted. 

63  -  PARTITION  IS  BUSY 

An  attempt  was  made  to  fix  a  task  in  a  main  partition  or 
subpartition  that  was  occupied;  to  fix  a  task  in  a  main 
partition  that  had  an  occupied  subpartition;  to  fix  a  task  in  a 
subpartition  that  had  an  occupied  main  partition;  or  to  load  a 
task  into  a  system-controlled  partition,  but  the  partition  did 
not  have  enough  contiguous  memory. 

65  -    INVALID  BLOCK   SIZE   ON    LOAD   DEVICE 

A  task  image  file  on  cassette  tape  had  a  block  size  not  able  to 
evenly  divide  into  512(10). 

66  -  FILE  NAME  REQUIRED 

No  file  name  was  specified  with  a  device  for  which  a  file  name  is 
required    (OTL  message). 
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66  -  LABEL  REQUIRED 


No  label  was  sp«clfi*d  with  a  device  for  which  one   Is   required 
(SIP  nessage)  . 

67  -   INVALID   LOAD  DEVICE 

The  version  of  OTL  or  SIP  in  use  did  not  support  or  was  not 
assembled  to  support  the  specified  device. 

68  -  TOO  MANY  WINDOW  BLOCKS 

The  task  would  requ*-  Tiore  than  8  APRs  (OTL  message). 
68-10  OUTSTANDING 

An  attempt  was  made  to  save  the  system  at  a  time  **en  one  or  more 
tasks  had  I/O  outstanding  (SIP  message) . 

69  -  TASK  BUILT  FOR  WRONG  SYSTEH 

OTL  has  determined  that  the  task  requires  features  that  the 
system  does  not  support.  The  task  was  built  for  an  RSX-llM-PLUS 
system  or  the  wrong  version  of  the  Task  Builder  was  used  to  build 
the  task.  (For  memory-resident  overlaid  tasks,  the  version  must 
be  RSX-llM  V3.2  or  greater.) 

70  -  ILLEGAL  USE  OP  INCREMENT 

This  message  is  returned  by  two  conditions: 

1.  The  specified  increment  causes  the  task  to  exceed  32K. 

2.  An  attempt  was  made  to  install  and  fix  an  overlaid  task 
with  an  increment.  Overlaid  tasks  cannot  be  loaded  with 
an  increment. 
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ABORT  command,  2-2 
Absolute  loader,  2-17 
ATL  command,  2-3 


Basic  MCR,  1-1,  2-1 

ABORT  command,  2-2 

ATL  command,  2-3 

BRK  command,  2-3 

building,  4-6 

CANCEL  command,  2-2 

command, 

initialization,  2-2 
system  maintenance,  2-3 
task  control,  2-2 

error  message,  2-4 

initiating,  2-1 

OPEN  command,  2-3 

REDIRECT  command,  2-2 

RESUME  command,  2-2 

RUN  command ,  2-2 

size,  1-3 

TAL  command,  2-4 

TIME  command,  2-2 
BRK  command,  2-3 


Device  common, 

loading,  4-13 
Device  driver, 

displaying,  information, 
2-22 

inserting,  into  Executive 
object  library,  4-5 

leading,  4-10 
Display  program,  2-1 

building,  4-9 

format,  2-22 

RSDV05,  1-1 

RSDVIH,  1-1 

size,  1-3 
Distribution  kit, 

contents,  3-1 

media,  3-1 


Error  message. 

See  Message 
Executive, 

building,  4-5 

configuring, 

using  VMR,  4-10 

size,  1-3 


CANCEL  command,  2-2 
CLI  symbol  table  space, 
VAX/VMS  host, 
displaying,  7-1 
setting,  7-1 
Common  block, 

displaying,  information, 

2-22 
fixing,  2-9 
installing,  2-9 
loading,  2-10 
Configuration, 
hardware,  1-2 
software,  1-2 


DECnet-11, 

down-line  loading  system 

image,  4-14 
installing  task,  4-14 
Device, 
load, 

OTL,  2-6 
status  message,  2-18 
supported, 
SIP,  2-15 


PCS, 

RSX-llS  subset,  2-23 
library, 

resident,  4-13 
system  object,  4-12 
using,  2-26 
File, 

distributee:  kit,  3-2 
additional  required, 
RSX-llM-PLUS  host,  3-4 
VAX/VMS  host,  3-4 
Executive, 

selecting  group  number, 
RSX-llM-PLUS  host,  4-3 
VAX/VMS  host,  7-1 
processing , 

control  routine,  2-25 
macro  call,  2-23 
system, 

selecting  group  number, 
RSX-llM-PLUS  host,  4-3 
VAX/VMS  host,  7-1 
File  Control  Services, 

See  FCS 
FORTRAN  OTS, 

system  object  library,  4-12 
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Hardware, 

configuration,  1-2 
Host  system,  1-2 


/INC  switch, 

OTL,  2-8 
I/O  driver, 

size,  1-3 
I/O  page, 

direct  access,  4-13 
I/O  processing,  2-23 


K-SERIES  lab  s<?pport  routine, 
generating,  4-9 


Library, 

Executive  object, 
inserting, 
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4-5 
device  driver,  4-5 
RSX-llS  subset  FCS  resident, 

4-13 
system  macro,  4-12 
system  object,  4-12 
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file-processing,  2-23 
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dlspla/ing,  2-22 
requirem(}nt,  1-3 
saving,  2-17 

maximum  size,  2-16 

determining,  2-17 
restriction,  2-17 
Message, 

Basic  MCR,  2-4 
OTL,  2-10 
SIP,  2-17 
summary,  A-1 
TKTN,  2-19 


Object  module, 
data  base, 

inserting,  into  Executive 
object  library,  4-3 
ODT, 

task-building  with, 
VAX/VMS  host,  7-2 


On-Line  Debugoing  Tool, 

See  ODT 
On-Llne  Task  Loader, 

See  OTL 
OPEN  command,  2-3 
OTL,  1-1,  2-1,  2-6 
building,  4-7 
command  line,  2-7 
device, 

supported,  2-6 
error  message,  2-10 
/INC  switch,  2-8 
initiating,  2-7 
loading, 

common  block,  2-10 

method,  2-9  to  2-10 

task,  2-9 
operation,  2-8 
partition, 

system-controlled,  2-6 
programming  hint,  2-9 
size,  1-3 
terminating,  2-7 
transferring  task,  2-7 


Paper  tape, 

system  image, 
booting,  2-17 
saving,  2-17 
Partition, 

creating,  4-10 

displaying,  information, 
2-22 

system-controlled,  2-6 
Phase  1, 

RSX-llM  host,  4-1 

RSX-llM-PLUS  host,  4-3 

SYSGEN,  1-2 
Phase  2, 

RSX-llM  host,  4-1 

RSX-llM-PLUS  host,  4-4 

SYSGEN,  1-2 


REDIRECT  command,  2- 
RESUME  command,  2-2 
RSD,  2-22 
RSDV05,  1-1,  2-1 

building,  4-9 

size,  1-3 
RSDVIH,  1-1,  2-1 

building,  4-9 

size,  1-3 


Index-2 


INDEX 


RSDV5P,  1-1,  2-1 
building,  4-9 
size,  1-3 
RSX-llM, 

host  system, 

copying  procedures,  4-2 
Phase  1,  4-1 
Phase  2,  4-1 
system  generation, 
baseline,  4-2 
invoking,  programs,  4-2 
on-line,  4-2 
preliminary,  5-2 
sample,  5-3 
relationship  with  RSX-llS. 
hardware,  1-2 
software,  1-1 
RSX-llM-PLUS, 
host  system, 

additional  required  file, 

3-4 
copying  procedure,  4-4 
distribution  kit,  4-3 
Phase  1,  4-3 
Phase  2,  4-4 

saving  RSX-llS  system,  4-5 
selecting  group  number. 
Executive  file,  4-3 
system  file,  4-3 
system  generation, 

invoking,  programs,  4-4 
multiple,  4-3 
preliminary,  6-2 
sample,  6-3 
target  disk,  4-3 
Task  Builder,  1-3,  4-5 
VMR,  1-3,  4-5 
RSXllS.OLB, 
inserting , 

data  base  object  module, 

4-5 
device  driver,  4-5 
RSXBLD.CMD,  4-5 
RSXMC.MAC,  4-5 
RUN  command,  2-2 


SETTIM,  2-1,  2-21 
generating,  4-8 

SIP,  1-1,  2-1,  2-14 
building,  4-R 
command  line,  2-15 
device, 

supj-ort*;} ,  2-15 
error  message,  2-17 
initiating,  2-15 
memory, 

maximum  size,  2-16 


SIP  (Cont.) 

determining,  2-17 
restricted  device,  2-17 
saving,  2-17 

restriction,  2-17 
operation,  2-16 
programming  hint,  2-16 
size,  1-3 
terminating,  2-15 
Software, 

configuration,  1-2 
minimum,  1-3 
suppl ied , 

Basic  MCR,  2-1 
display  program,  2-1 
OTL,  2-1 
RSDV05,  2-1 
RSDVIH,  2-1 
RSDV52,  2-1 
SETTIM,  2-1 
SIP,  2-1 
TKTN,  2-1 
Support  routine, 
I/O  page, 

direct  access,  4-13 
SYSGEN, 

See  System  generation 
System, 

displaying,  information, 

2-22 
host,  1-2 
saving , 

RSX-llM-PLUS  host,  4-5 
time, 

setting,  2-21 
System  generation. 
Phase  1,  1-2 
Phase  2,  1-2 
prel iminary, 

RSX-llM  host,  5-2 
RSX-llM-PLUS  most,  6-2 
VAX/VMS  host ,  7-6 
RSX-llM  host,  l-l 
RSX-llM-PLUS  host,  4-3 
sample , 

RSX-llM  host,  5-3 
RSX-llM-PLUS  host,  6-3 
VAX/VMS  host,  7-7 
VAX/VMS  host,  7-1 
System  image, 
booting,  2-16 

paper  tape,  2-17 
bootstrapping,  4-14 
down-line  loading, 

using  DECnpt-11,  4-14 
saving,  2-14 

papar  tape,  2-17 
system  console, 

VAX/VMS  host,  7-4 


Index-J 


INDEX 


System  image  (Cont.) 
using  VMR,  4-14 

transporting,  2-16 
System  Image  Preservation 
program. 

See  SIP 
System  task, 

Basic  MCP,  1-1 

building,  4-5 

display  program,  1-1 

OTL,  1-1 

RGDV05,  1-1 

RSDVIH,  1-1 

RSDV52,  1-1 

SIP,  1-1 

TKTN,  1-1 


TAL  command,  2-4 
Task, 

aborting, 

message,  2-18 
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building,    2-9 

ODT, 

VAX/VMS  host,  7-2 
checkpointable,  2-9 
compiling,  1-2 
disk-overlaid,  2-9 
displaying,  information, 

2-22 
fixirg,  2-9,  4-10 
installing,  2-6,  2-9,  4-10 
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2-9 
system, 

Basic  MCR,  1-1 
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OTL,  1-1 

RSDV05,  1-1 

WSDVIH,  1-1 

RSDV52,  1-1 

SIP,  1-1 

TKTN,  1-1 
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message,  2-18 
transferring, 

OTL,  2-7 
transporting,  1-2,  2-6 
user-written , 

including,  4-10 
writing,  1-2 
Task  Builder, 

RSX-llM-PLUS  host,  1-3,  4-5 
VAX/VMS  host,  1-3 


Task  Termination  Notification 
program. 

See  TKTN 
Time, 

system, 

setting,  2-21 
TIME  command,  2-2 
TKB, 

See  Task  Builder 
TKTN,  1-1,  2-1,  2-18 

building,  4-6 

error  message,  2-19 

initiating,  2-19 

size,  1-3 


UIC, 

targeting, 

RSX-llM-PLUS  host,  4-3 
VAX/VMS  host,  7-1 


VAX/VMS, 

host  system, 

additional  required  file, 
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CLI  symbol  table  space, 
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setting,  7-1 
distribution  kit, 
disk,  7-3 
tape,  7-3 
privilege, 

displaying,  7-3 
setting,  7-2 
selecting  group  number. 
Executive  file,  7-1 
system  file,  7-1 
system  generation, 
multiple,  7-1 
preliminary,  7-6 
sample,  7-7 
target  disk,  7-1 
Task  Builder,  1-3 
task-building, 

ODT,  7-2 
VMR,  1-3 
Virtual  Monitor  Console 
Routine, 
See  VMR 
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creating  partition,  4-10 
installing  task,  4-10,  4-14 
loading  device  driver,  4-10 
RSX-llM-PLUS  host,  1-3,  4-5 
saving  system  image,  4-14 
VAX/VMS  host,  1-3 
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